# EasyTier 开机自启动部署教程

EasyTier 开机自启动部署教程

仅供参考，禁止照抄

环境信息

系统：Fedora 44
安装目录：/opt/easytier/
服务以 root 用户运行

文件说明

文件	说明
`/opt/easytier/easytier-web-embed`	Web 管理界面（嵌入版）
`/opt/easytier/easytier-core`	核心组网服务
`/opt/easytier/easytier-cli`	命令行工具
`/opt/easytier/et.db`	SQLite 数据库

部署步骤

1. 创建服务文件

easytier-web 服务：

bash 复制代码

sudo tee /etc/systemd/system/easytier-web.service > /dev/null << 'EOF'
[Unit]
Description=EasyTier Web Interface
After=multi-user.target

[Service]
Type=simple
WorkingDirectory=/opt/easytier
ExecStart=/opt/easytier/easytier-web-embed
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

easytier-core 服务：

bash 复制代码

sudo tee /etc/systemd/system/easytier-core.service > /dev/null << 'EOF'
[Unit]
Description=EasyTier Core Service
After=multi-user.target easytier-web.service

[Service]
Type=simple
WorkingDirectory=/opt/easytier
ExecStart=/opt/easytier/easytier-core -w udp://127.0.0.1:22020/aning
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

2. 启用并启动服务

bash 复制代码

sudo systemctl daemon-reload
sudo systemctl enable --now easytier-web.service easytier-core.service

3. 验证状态

bash 复制代码

sudo systemctl status easytier-web.service
sudo systemctl status easytier-core.service

常用管理命令

bash 复制代码

# 查看状态
sudo systemctl status easytier-web.service
sudo systemctl status easytier-core.service

# 停止服务
sudo systemctl stop easytier-core.service
sudo systemctl stop easytier-web.service

# 启动服务
sudo systemctl start easytier-web.service
sudo systemctl start easytier-core.service

# 重启服务
sudo systemctl restart easytier-web.service
sudo systemctl restart easytier-core.service

# 查看日志（实时跟踪）
sudo journalctl -u easytier-web.service -f
sudo journalctl -u easytier-core.service -f

# 查看最近日志
sudo journalctl -u easytier-web.service -n 50
sudo journalctl -u easytier-core.service -n 50

# 禁用开机自启
sudo systemctl disable easytier-web.service
sudo systemctl disable easytier-core.service

卸载服务

bash 复制代码

sudo systemctl stop easytier-core.service easytier-web.service
sudo systemctl disable easytier-core.service easytier-web.service
sudo rm /etc/systemd/system/easytier-web.service
sudo rm /etc/systemd/system/easytier-core.service
sudo systemctl daemon-reload

参数说明

服务文件关键字段

字段	说明
`After=multi-user.target`	多用户模式就绪后启动
`After=... easytier-web.service`	easytier-core 等 easytier-web 启动后再启动
`WorkingDirectory=/opt/easytier`	工作目录，等同于 cd 到该目录
`Restart=always`	无论什么原因退出都自动重启
`RestartSec=5`	重启间隔 5 秒
`WantedBy=multi-user.target`	开机自启动

ExecStart 命令参数

bash 复制代码

/opt/easytier/easytier-core -w udp://127.0.0.1:22020/aning

参数	说明
`-w`	使用 Web 管理界面模式
`udp://127.0.0.1:22020/aning`	Web API 监听地址 + 网络名称

如需修改网络名称，编辑 ExecStart 行中的 URL 最后一段（aning 部分）。

故障排查

bash 复制代码

# 查看服务启动失败原因
sudo systemctl status easytier-web.service -l
sudo systemctl status easytier-core.service -l

# 查看详细日志
sudo journalctl -xeu easytier-web.service
sudo journalctl -xeu easytier-core.service

# 检查端口是否被占用
sudo ss -tlnp | grep -E '22020|11010'

# 测试手动启动
cd /opt/easytier && sudo ./easytier-web-embed
cd /opt/easytier && sudo ./easytier-core -w udp://127.0.0.1:22020/aning