🚀 Nginx-Manager 部署指南

Nginx + FRP + Easytier 三合一可视化管理面板 | 5 分钟上手

📋 前置条件

第一步：创建目录

mkdir -p /opt/nginx-manager/templates
cd /opt/nginx-manager

第二步：放入部署文件

将以下 5 个文件 放入 /opt/nginx-manager/ 目录：

/opt/nginx-manager/
├── Dockerfile
├── docker-compose.yml
├── app.py
├── requirements.txt
└── templates/
    └── index.html

第三步：修改 docker-compose.yml

⚠️ 必须修改：根据你的实际环境调整以下配置。
修改项说明
ports面板访问端口，默认 9000:5000
FRP 挂载路径改为实际 frp 配置目录
飞牛 frpc：/vol1/1000/docker/frpc:/etc/frp
阿里云 frps：/opt/frps:/etc/frp
FRP_CONTAINERfrps 或 frpc
Easytier 挂载路径改为实际 easytier 配置目录
EASYTTER_CONTAINER默认 easytier
💡 提示：如果不需要 FRP 或 Easytier 管理，删除对应的 volumes 和 environment 行即可。

第四步：选择 Nginx 重载方式

app.py 默认使用 nsenter 方式（Nginx 在宿主机）。

⚠️ 如果 Nginx 在 Docker 容器内，需修改 reload_nginx 函数：
# 改为 docker exec 方式
subprocess.run(['docker', 'exec', 'nginx', 'nginx', '-t'], ...)
subprocess.run(['docker', 'exec', 'nginx', 'nginx', '-s', 'reload'], ...)

第五步：启动

sudo docker compose up -d --build

第六步：登录面板

浏览器访问：http://<服务器IP>:9000

默认账号默认密码
adminadmin123

第七步：初始配置

  1. 修改密码：右上角「修改密码」
  2. 系统设置：填写 DNS API 凭据 → 保存（可选，用于自动申请 SSL 证书）
  3. 站点管理：添加域名 + 后端地址 → 完成

❓ 常见问题

问题解决方法
添加站点后不生效 点击面板「重载 Nginx」按钮，或终端执行 sudo systemctl reload nginx
域名被抢端口 在 nginx.conf 的 http 块中添加：
server_names_hash_bucket_size 4096;
飞牛管理界面一直转圈 需要 WebSocket 支持，手动补配置：
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
GitHub 下载 acme.sh 很慢 先在阿里云 ECS 下载，再 scp 到飞牛 NAS
面板重载按钮无效 终端执行 sudo systemctl reload nginx 代替

🎉 部署完成

面板已就绪！ 现在可以：
• 📋 管理 Nginx 站点（增删改查 + 重载）
• 🔐 申请/续期 Let's Encrypt 证书
• 📄 查看 Nginx 日志
• 🔗 管理 FRP 隧道
• 🌐 管理 Easytier 组网

— Nginx-Manager 部署指南 —