Skip to content

命令行参数 ​

当前入口只识别下面这几个参数,值必须用 = 传入(如 -c=config/config.toml)。

参数说明等价环境变量
-c= / -config=配置文件路径GOPANEL_CONFIG
-version输出版本号后退出GOPANEL_VERSION=1/true/yes/on
-se / -entry[=URL]打印当前安全访问入口 URL(未启用安全入口时打印普通登录地址)GOPANEL_ENTRY=1
-sr / -reset-entry[=URL]重置安全入口随机路径并打印新入口 URL(旧地址立即失效)GOPANEL_ENTRY_RESET=1
-rp / -reset-password[=<值>]重置后台登录密码(见下)GOPANEL_RESET_PASSWORD
-h / --help显示帮助—

空格分隔写法(-c config/config.toml)与其它未知参数一律忽略并打一条 warn 日志, 不会再让容器因为 flag provided but not defined: -c 直接退出。

-rp 重置后台密码 ​

bash
./GoPanel -rp                    # 创始人为 16 位随机密码并打印
./GoPanel -rp=新密码              # 创始人为指定密码
./GoPanel -rp=用户名:新密码        # 重置指定用户(按第一个冒号拆分,密码可含冒号)
  • 密码强度与安装向导同一套规则(8-64 位,至少含字母 / 数字 / 符号两类)
  • 只改密码即退出:不启动服务、不初始化日志、不执行数据库迁移
  • 未安装的库不会被顺手建表;库中无用户时提示先完成安装向导
  • 目标账号被禁用时给出提示

-se / -sr 与地址前缀 ​

-se / -sr 支持可选 URL 值作为站点地址前缀:

bash
./GoPanel -se=https://panel.example.com

也可用 GOPANEL_BASE_URL 提供;未提供时按「主机名 + 管理后台端口」推断。 域名 / 反代部署建议显式传入,或直接使用输出里的「相对路径」拼接。

这两个命令只读写数据库并打印地址,不启动服务,容器内可直接执行:

bash
docker exec gopanel /home/gopanel/GoPanel -se

不存在的参数 ​

以下参数在当前版本中不存在,传入会被忽略并打印 warn 日志:

  • -install / -uninstall / -service / -sudo-pass / -service-user —— 服务注册由下载安装脚本调用主程序内置的 glsm v2 完成; 源码编译的二进制不再内置服务注册,请自写 systemd unit
  • -ul(解锁 IP 黑名单)—— 重启进程即可清空内存中的锁定记录
  • -port / -host / -http-port / -https-port / -root / -http2 / -quic / -grace —— 本程序是单一监听端口的管理后台,端口由环境变量 / 配置文件提供

取值优先级 ​

text
环境变量 > 命令行参数 > 配置文件 > 内置默认值

配置由 viper 统一解析。

相关 ​

基于 AGPL-3.0 协议发布