fan-nginx

命令

fan-nginx Nginx 图形化管理平台（nginxWebUI 延续精简版）部署运维

一键脚本

功能	命令	说明
管理工具	`bash <(curl -sL ../sh/fan-nginx_menu.sh)`	交互式管理菜单（启停/状态/日志/密码/安装/备份/恢复/卸载）
Compose 部署	`bash <(curl -sL ../sh/dc_inst_fan-nginx.sh) 8080 /vol1/1000/compose/fan-nginx`	一键 Compose 部署（host 网络）

Docker 运行

docker run -itd \
  --name fan-nginx \
  --restart always \
  -v /home/fan-nginx:/home/fan-nginx \
  -e BOOT_OPTIONS="--server.port=8080 --init.admin=admin --init.pass=你的强密码" \
  --net=host \
  mobufan/fan-nginx:latest

必须使用 --net=host：内部 nginx 使用任意端口做反代/负载均衡，需直通本机全部端口
数据目录 /home/fan-nginx（数据库、nginx 配置、证书、日志）bind 挂载，升级镜像不丢数据
日志默认在 /home/fan-nginx/log/fan-nginx.log（logback 写文件，docker compose logs 可能为空属正常）
host 网络下修改端口：改 BOOT_OPTIONS 里的 --server.port 后重建容器即可

systemd 脚本安装（原生部署）

# 交互式安装
bash scripts/install.sh

# 静默安装：端口 8080 + 数据目录 /var/lib/fan-nginx + 初始化管理员
bash scripts/install.sh -p 8080 -d /var/lib/fan-nginx -u admin -P 123456

# 在线下载 GitHub Releases 预编译 jar（默认方式，无需源码/maven）
bash scripts/install.sh -p 8080 -b

# 远程一键安装
bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-nginx/main/scripts/install.sh)"

参数	说明
`-p, --port`	监听端口（默认 8080）
`-d, --data`	数据目录 project.home（默认 /var/lib/fan-nginx）
`-j, --jar`	本地 jar 发行包路径
`-s, --src`	源码仓库路径
`-b, --binary`	强制在线下载预编译 jar
`-u/-P`	初始管理员账号/密码（仅首次启动生效）
`-y, --yes`	免交互，未指定项用默认值
`FAN_NGINX_VERSION`	指定下载版本（默认 latest）
`FAN_NGINX_REPO`	自定义仓库/镜像地址（国内网络加速）

内置 CLI 命令

安装后生成 /usr/local/bin/fan-nginx，支持：

fan-nginx status                    # 运行方式/systemd状态/PID/端口/访问地址/运行时长/内存/路径
fan-nginx credentials               # 重置并打印全部管理员账号密码（关闭两步验证）
fan-nginx start | stop | restart    # 启停/重启 systemd 服务
fan-nginx version                   # 显示版本号
fan-nginx uninstall -y --purge      # 卸载（默认保留数据目录）

忘记管理密码：fan-nginx credentials 一次搞定，无需进数据库

备份与恢复

# 备份（在线打包、不停服，保留 6 份，自动排除 log 目录）
bash <(curl -sL https://raw.githubusercontent.com/meimolihan/fan-nginx/main/scripts/fan-nginx_backup.sh) /vol2/1000/file/backup/fan-nginx-backup 6

# 恢复（自动取最新备份：停服→清空→解压→启动）
bash <(curl -sL https://raw.githubusercontent.com/meimolihan/fan-nginx/main/scripts/fan-nginx_recover.sh) /vol2/1000/file/backup/fan-nginx-backup

# 恢复指定备份文件
bash <(curl -sL https://raw.githubusercontent.com/meimolihan/fan-nginx/main/scripts/fan-nginx_recover.sh) /vol2/1000/file/backup/fan-nginx-backup "FanNginx-2026-09-24_12-00-00.tar.gz"

备份产物：FanNginx-YYYY-MM-DD_HH-MM-SS.tar.gz（纯数据文件 tar.gz，不含 log）
备份路径：默认为 ${APP_DIR}/backup（systemd 安装即 /var/lib/fan-nginx/backup，默认保留 6 份）

服务管理

sudo systemctl start|stop|restart|status fan-nginx        # 启停/状态
sudo systemctl enable|disable fan-nginx                   # 开机自启
sudo journalctl -u fan-nginx -n 100                       # 最近100行日志
sudo journalctl -u fan-nginx -f                           # 实时跟踪日志
sudo systemctl status fan-nginx --no-pager                # 查看进程 PID/状态详情

卸载

# systemd 方式
bash -c "$(curl -sSL https://raw.githubusercontent.com/meimolihan/fan-nginx/main/scripts/uninstall.sh)" -y --purge

# Docker 方式
docker rm -f fan-nginx && docker rmi -f mobufan/fan-nginx

数据目录说明

systemd 安装默认数据目录：/var/lib/fan-nginx（数据库、nginx 配置、证书、日志）
Docker/Compose 数据目录：宿主 /home/fan-nginx（bind 挂载）
安装记录：/etc/fan-nginx.conf（记录 APP_DIR、PORT、DATA_DIR、JAR_PATH 等）
日志位置：${DATA_DIR}/log/fan-nginx.log
首次登录：安装脚本若指定 -u/-P 用其账号密码；否则 fan-nginx credentials 查看/重置（数据目录已存在管理员时 --init.* 不覆盖）

项目简介

fan-nginx 是 Nginx 图形化管理平台（nginxWebUI 的延续精简版），一体化管理 Nginx 的配置、证书、反向代理、负载均衡与健康检查，支持 ACME 自动签发/续期证书。基于 Java（Solon/JDK8）开发，镜像内含完整 Nginx 及 stream/rtmp/lua/brotli/zstd 等扩展模块。

GitHub 项目地址：https://github.com/meimolihan/fan-nginx
**Docker 镜像：https://hub.docker.com/r/mobufan/fan-nginx**（另同步 ghcr.io/meimolihan/fan-nginx 与 cnb.cool/meimolihan/fan-nginx）

快捷访问

功能	地址
Web 面板	`http://IP:8080`（默认端口可在 BOOT_OPTIONS/install.sh 修改）
默认账号	`admin`（systemd 安装时用 `-u/-P` 指定，或 `fan-nginx credentials` 重置）