dec0dOS/zero-ui
1
1
Fork 0
mirror of https://github.com/dec0dOS/zero-ui.git synced 2024-11-10 09:13:36 +08:00
Code Issues Projects Releases Packages Wiki Activity
ZeroUI - ZeroTier Controller Web UI - is a web user interface for a self-hosted ZeroTier network controller.
143 commits 4 branches 39 tags 92 MiB
JavaScript 96.7%
Dockerfile 1.9%
CSS 0.7%
HTML 0.6%
Shell 0.1%
Find a file
Timothy Le efb768fcef
Updated peerData.online parsing 
Set peerData.online to 0 if peer is not found in peers list
Set peerData.online to 1 if peer is found in peers list and latency is not -1 (i.e. a direct route exists)
Set peerData.online to 2 if peer is found in peers list and latency is -1 (i.e. relayed connection)
2021-12-17 22:04:17 -08:00
.github ci: update feature request template 2021-12-17 16:20:19 +03:00
.husky chore(package.json): better dev tools 2021-03-29 01:13:34 +03:00
.yarn fix: migrate to yarn v3 2021-12-16 16:00:31 +03:00
backend Updated peerData.online parsing 2021-12-17 22:04:17 -08:00
docker ci: fix dockerfile 2021-12-16 16:30:37 +03:00
docs docs: update SECURITY.md 2021-11-10 18:14:04 +03:00
frontend fix: migrate to yarn v3 2021-12-16 16:00:31 +03:00
.dockerignore chore: add .github to .dockerignore 2021-05-15 12:31:24 +03:00
.gitignore refactor: squash commits 2021-03-21 22:25:13 +03:00
.yarnrc.yml fix: migrate to yarn v3 2021-12-16 16:00:31 +03:00
CHANGELOG.md chore(release): 1.1.5 2021-12-16 16:53:25 +03:00
docker-compose.yml refactor: squash commits 2021-03-21 22:25:13 +03:00
LICENSE docs(license): update license copyright 2021-05-10 12:45:38 +03:00
package.json chore(release): 1.1.5 2021-12-16 16:53:25 +03:00
README.md docs: sync with amazing-github-template 2021-11-10 18:13:01 +03:00
yarn.lock fix: migrate to yarn v3 2021-12-16 16:00:31 +03:00

README.md


Logo

ZeroUI - ZeroTier Controller Web UI - is a web user interface for a self-hosted ZeroTier network controller.
Explore the screenshots »

Report Bug · Request Feature · Ask a Question

Table of Contents

About

This project is highly inspired by ztncui and was developed to address the current limitations of applying the self-hosted network controllers. Some ztncui problems cannot be fixed because of the core architecture of the project. ZeroUI tries to solve them and implements the following features:

  • Full React-powered lightweight SPA that brings better user experience, and ZeroUI is mobile-friendly.
  • ZeroUI has ZeroTier Central compatible API. That means you could use CLI tools and custom applications made only for ZeroTier Central to manage your networks.
  • ZeroUI implements controller-specific workarounds that address some existing issues. ZTNCUI does not.
  • ZeroUI is more feature complete. ZeroUI has almost all network-controller supported features, for example, rule editor. The development process hasn't stopped, so you will enjoy new features and bug fixes in the near future.
  • ZeroUI deployment is simple. Please refer to installation for more info.
Wait, I haven't heard about ZeroTier yet...

ZeroTier is awesome open source project that is available on wide range of platforms. Most of your hard networking problems could be solved with ZeroTier. It could replace all your complex VPN setups. You can place all your devices on a virtual LAN and manage it easily.

To sum up, ZeroTier combines the capabilities of VPN and SD-WAN, simplifying network management.

Built With

Frontend:

Backend:

Deploy:

Getting Started

Prerequisites

The recommended method to install ZeroUI is by using Docker and Docker Compose. To install Docker and Docker Compose on your system, please follow the installation guide from the official Docker documentation.

For HTTPS setup you will need a domain name.

Installation

The most simple one-minute installation. Great for the fresh VPS setup.

  1. Download the docker-compose.yml file 
    wget https://raw.githubusercontent.com/dec0dOS/zero-ui/main/docker-compose.yml
    or 
    curl -L -O https://raw.githubusercontent.com/dec0dOS/zero-ui/main/docker-compose.yml
  2. Replace example.com with your domain name in docker-compose.yml
  3. Pull the images 
    docker-compose pull
  4. Run the containers 
     docker-compose up -d --no-build
  5. Check if everything is okay (CTRL-C to stop log preview) 
     docker-compose logs -f
  6. Disable your firewall for the following ports: 80/tcp, 443/tcp and 9993/udp
    • on ubuntu/debian with ufw installed: 
      ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 9993/udp
    • or you may use the old good iptables: 
      iptables -A INPUT -p tcp --dport 80 -j ACCEPT
iptables -A INPUT -p tcp --dport 443 -j ACCEPT
iptables -A INPUT -p udp --dport 9993 -j ACCEPT
  7. Navigate to https://YOURDOMAIN.com/app/. Now you could use your ZeroUI instance with HTTPS support and automated certificate renewal.

To disable HTTPS, please remove https-proxy from docker-compose.yml, set ZU_SECURE_HEADERS to false and change zero-ui port expose to ports.

Advanced manual setups are also supported. Check the following environment variables as a reference:

Name Default value Description
NODE_ENV unset You could learn more here
LISTEN_ADDRESS 0.0.0.0 Express server listen address
ZU_SERVE_FRONTEND true You could disable frontend serving and use ZeroUI instance as REST API for your ZeroTier controller
ZU_SECURE_HEADERS true Enables helmet
ZU_CONTROLLER_ENDPOINT http://localhost:9993/ ZeroTier controller API endpoint
ZU_CONTROLLER_TOKEN from /var/lib/zerotier-one/authtoken.secret ZeroTier controller API token
ZU_DEFAULT_USERNAME unset (docker-compose.yml: admin) Default username that will be set on the first run
ZU_DEFAULT_PASSWORD unset (docker-compose.yml: zero-ui) Default password that will be set on the first run
ZU_DATAPATH data/db.json ZeroUI data storage path

ZeroUI could be deployed as a regular nodejs web application, but it requires ZeroTier controller that is installed with zerotier-one package. More info about the network controller you could read here.

Controller setup tips

If you are using the existing controller on the host, it may be necessary to allow connection from the Docker container. You could do it in two ways:

  1. Allowing controller management from any IP address:
echo "{\"settings\": {\"portMappingEnabled\": true,\"softwareUpdate\": \"disable\",\"allowManagementFrom\": [\"0.0.0.0/0\"]}}" > /var/lib/zerotier-one/local.conf

Warning: don't forget to block connections to 9993/TCP from WAN. Direct controller API does not mean to be exposed to WAN, it should be proxified via ZeroUI backend.

  1. Adding network_mode: "host" to zero-ui in docker-compose.yml.

More info is provided in the following discussion.

Usage

After installation, log in with your credentials that are declared with ZU_DEFAULT_USERNAME and ZU_DEFAULT_PASSWORD.

Currently, almost all main ZeroTier Central features are available. Refer to the roadmap for more information.

For the screenshots, please refer to the screenshots.

Update

To get the latest version just run

docker-compose pull && docker-compose up -d --no-build

in the folder where docker-compose.yml is located. Backup is not required as your data is saved in Docker volumes but recommended. You could also set up watchtower for automatic updates.

docker run -d \
    --name watchtower \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --restart always \
    containrrr/watchtower \
    --cleanup --include-restarting \
    zu-main zu-controller

Backup

The easiest way to create your ZeroUI data backup is to use the following commands:

docker run --rm --volumes-from zu-controller -v $(pwd):/backup ubuntu tar cvf /backup/backup-controller.tar /var/lib/zerotier-one
docker run --rm --volumes-from zu-main -v $(pwd):/backup ubuntu tar cvf /backup/backup-ui.tar /app/backend/data

Roadmap

See the open issues for a list of proposed features (and known issues).

GitHub issues open

Please try to create bug reports that are:

  • Reproducible. Include steps to reproduce the problem.
  • Specific. Include as much detail as possible: which version, what environment, etc.
  • Unique. Do not duplicate existing opened issues.
  • Scoped to a Single Bug. One bug per report.

Contributing

First off, thanks for taking the time to contribute! Contributions are what makes the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

  1. Fork the project
  2. Create your feature branch (git checkout -b feat/amazing_feature)
  3. Commit your changes (git commit -m 'feat: add amazing_feature')
  4. Push to the branch (git push origin feat/amazing_feature)
  5. Open a Pull Request

ZeroUI uses conventional commits, so please follow the guidelines. Run yarn commit to open TUI that follows conventional commits guidelines.

Development environment

To set up a development environment, please follow these steps:

  1. Clone the repo 
    git clone https://github.com/dec0dOS/zero-ui.git
  2. Install packages 
    yarn install && yarn installDeps
  3. Start the development server 
    yarn dev
  4. Navigate to http://localhost:3000

It is also required to install ZeroTier controller. On Linux installing zerotier-one package is enough, other platforms require some tweaking. Firstly you should get the controller token. On macOS, you could find it with the following command:

sudo cat "/Library/Application Support/ZeroTier/One/authtoken.secret"

After you could start ZeroUI development environment:

ZU_CONTROLLER_TOKEN=TOKEN_FROM_authtoken.secret yarn dev

For other platforms, please refer to ZeroTier manual.

Support

Reach out to me at one of the following places:

Security

ZeroUI follows good practices of security, but 100% security cannot be assured. ZeroUI is provided "as is" without any warranty. Use at your own risk.

For enterprise support, a more reliable and scalable solution, please use ZeroTier Central.

For more information and to report security issues, please refer to our security documentation.

Copyright notice

ZeroUI is not affiliated or associated with or endorsed by ZeroTier Central or ZeroTier, Inc.

License

License: GPL v3

See LICENSE for more information.