Docker-ZeroTierOne 控制器项目启动与配置教程

Docker-ZeroTierOne 控制器项目启动与配置教程

docker-zerotier-controller Dockernized ZeroTierOne Controller 项目地址: https://gitcode.com/gh_mirrors/do/docker-zerotier-controller

1. 项目的目录结构及介绍

该项目是基于 Docker 的 ZeroTierOne 控制器，包含了一个 Web 界面（zero-ui），用于管理 ZeroTierOne 的网络。以下是项目的目录结构：

• config/：存放 ZeroTierOne 的配置文件，如身份文件（identity.public 和 identity.secret）以及认证令牌（authtoken.secret）。
• backend/：zero-ui 的后端代码，用于处理 Web 界面的逻辑。
• frontend/：zero-ui 的前端代码，包含了静态文件，如 HTML、CSS 和 JavaScript。
• ZeroTierOne/：ZeroTierOne 的二进制文件，包括 zerotier-* 和 mkworld 等工具。
• .github/workflows/：GitHub Actions 工作流配置文件，用于自动化构建和测试等操作。
• Dockerfile：Dockerfile 文件用于构建包含所有必要组件的 Docker 镜像。
• LICENSE：项目使用的 MIT 许可证文件。
• README.md：项目的自述文件，包含了项目说明和使用指南。

2. 项目的启动文件介绍

项目的主要启动文件是 Dockerfile，以下是 Dockerfile 的基本内容：

# 使用的基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY . .

# 安装依赖
RUN pip install --no-cache-dir -r requirements.txt

# 暴露容器端口
EXPOSE 3000 4000 9993

# 运行命令
CMD ["python", "backend/app.py"]

使用该 Dockerfile，可以构建一个包含 ZeroTierOne 控制器所有必要的 Python 应用和静态文件的 Docker 镜像。

启动项目的命令如下：

docker build --force-rm . -t sbilly/zerotier-controller:latest
docker run --rm -ti -p 4000:4000 -p 9993:9993 -p 9993:9993/udp sbilly/zerotier-controller:latest

3. 项目的配置文件介绍

项目的配置主要通过环境变量进行，以下是部分可配置的环境变量：

• ZU_SECURE_HEADERS：是否启用安全头部，默认为 true。
• ZU_CONTROLLER_ENDPOINT：ZeroTierOne 控制器的连接端点，默认为 http://127.0.0.1:9993/。
• ZU_DEFAULT_USERNAME 和 ZU_DEFAULT_PASSWORD：Web 界面的默认用户名和密码，默认分别为 admin 和 zero-ui。

此外，还需要配置 ZeroTierOne 的身份文件和认证令牌。在 config/ 目录中，需要放置 identity.public、identity.secret 和 authtoken.secret 文件。

如果需要挂载外部配置文件到容器中，可以使用以下命令：

docker run --rm -ti -v $(pwd)/config/identity.public:/app/config/identity.public \
-v $(pwd)/config/identity.secret:/app/config/identity.secret \
-v $(pwd)/config/authtoken.secret:/app/config/authtoken.secret \
-p 3000:3000 -p 4000:4000 -p 9993:9993 -p 9993:9993/udp sbilly/zerotier-controller:latest

以上是该项目的基本启动和配置指南。在实际应用中，可能还需要进一步调整配置以适应特定的网络环境和安全需求。

docker-zerotier-controller Dockernized ZeroTierOne Controller 项目地址: https://gitcode.com/gh_mirrors/do/docker-zerotier-controller