An open API service indexing awesome lists of open source software.

https://github.com/sudo-ivan/tailscale-acl-builder

Build and visualize your Tailscale ACL.
https://github.com/sudo-ivan/tailscale-acl-builder

reactflow tailscale tailscale-acl

Last synced: 6 months ago
JSON representation

Build and visualize your Tailscale ACL.

Awesome Lists containing this project

README

          

# Tailscale-ACL-Builder

> [!NOTE]
> Public deployment: https://tailscale-acl-builder.q4dd.com/

Build and visualize Tailscale ACLs with a reactflow diagram.

![Tailscale ACL Builder Showcase](./showcase/showcase.png)

## Features

- **Visual ACL Building**: Drag-and-drop interface for creating Tailscale ACLs
- **Node Types**:
- Source nodes (users, groups, tags)
- Destination nodes (IP:port)
- Action nodes (accept/deny)
- Tag nodes for tag definitions
- **Real-time Validation**:
- Source format validation (email, group:name, tag:name)
- Destination format validation (IP:port)
- Action validation (accept/deny)
- Tag format validation
- **Import/Export**:
- Import existing Tailscale ACL JSON
- Export flow as JSON
- Copy ACL to clipboard
- **Search & Filter**:
- Search through nodes by value
- Filter visible nodes dynamically
- **Visual Tools**:
- Mini-map for navigation
- Node controls
- Dark mode interface
- **Keyboard Shortcuts**:
- Delete selected nodes
- Reset flow
- **HuJSON Support**:
- Parse and validate HuJSON format
- Maintain comments in ACL configuration

## Deployment

### Docker/Podman

```
docker run -p 8080:8080 ghcr.io/sudo-ivan/tailscale-acl-builder:latest
```

### Bun

```
bun run start
```

## To Do

- [ ] Templates for common ACLs
- [ ] More tailscale ACL sytax support
- [ ] Auto-visualize
- [ ] Error Syntax highlighting for HuJSON
- [ ] Fix synchronization issues between the sidebar and the nodes/graph

## Contributing

Feel free to open an issue or submit a PR to improve the project.