ZTNET安装与配置指南

魏栋赢

于 2025-04-09 10:58:41 发布

阅读量721

点赞数 29

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00686/article/details/147088511

ZTNET安装与配置指南

ztnet ZTNET - ZeroTier Web UI for Private Controllers with Multiuser and Organization Support. 项目地址: https://gitcode.com/gh_mirrors/zt/ztnet

1. 项目基础介绍

ZTNET 是一个开源项目，旨在提供一个自托管的 ZeroTier 网络控制器的 Web 界面。它支持多用户和组织功能，使得管理 ZeroTier 网络变得更加简单和高效。ZTNET 以其丰富的特性和直观的用户界面，为网络管理带来了一种新的体验。

主要编程语言

TypeScript
Shell
JavaScript
Go

2. 项目使用的关键技术和框架

ZTNET 使用以下关键技术和框架构建：

Next.js: 用于构建服务端渲染的 React 应用程序。
Tailwind CSS: 一个功能类优先的 CSS 框架，用于快速UI开发。
ZeroTier One: 一个开源的软件定义网络（SDN）工具，用于创建和管理虚拟私有网络。
TypeScript: JavaScript 的一个超集，添加了静态类型选项。
Go: 用于后端服务的编程语言，提供高性能的网络处理能力。

3. 项目安装和配置的准备工作与详细步骤

准备工作

在开始安装 ZTNET 之前，请确保您的系统满足以下要求：

Node.js 和 npm：用于安装项目依赖。
Docker：用于运行数据库和网络服务。
Git：用于克隆项目仓库。

安装步骤

克隆项目仓库

打开终端，执行以下命令来克隆项目：
```
git clone https://github.com/sinamics/ztnet.git
cd ztnet
```
安装依赖

在项目目录中，运行以下命令安装 Node.js 依赖：
```
npm install
```

配置环境变量

在项目根目录中创建一个 .env 文件，并添加必要的环境变量：

NEXT_PUBLIC_ZERO_TIER_API_TOKEN=你的ZeroTier API令牌
NEXT_PUBLIC_ZERO_TIERController_URL=你的ZeroTier控制器URL
DB_HOST=数据库主机
DB_USER=数据库用户
DB_PASS=数据库密码
DB_DATABASE=数据库名称

启动数据库

使用 Docker 启动数据库：
```
docker-compose up -d db
```
初始化数据库

运行以下脚本初始化数据库：
```
./init-db.sh
```
启动项目

运行以下命令启动 ZTNET：
```
npm run dev
```
项目将在本地开发服务器上运行，通常可通过 http://localhost:3000 访问。