启动参数、配置文件与环境变量：Web 版配置全解

Web 版提供三种等价配置方式：命令行参数、config.json 文件、环境变量，覆盖从临时试跑到长期运维的所有场景。

命令行参数

主程序加 -h 查看全部参数，核心几个：

config.json 配置文件

在运行目录创建 config.json：

{
  "address": "",
  "port": 0,
  "username": "",
  "password": "",
  "apiToken": "",
  "storageDir": "",
  "whiteDownloadDirs": ["/root/downloads"]
}

字段与命令行参数一一对应。想在服务端首次启动就预置下载行为，加 downloadConfig 字段指定默认下载目录：

{
  "downloadConfig": {
    "downloadDir": "d:/test"
  }
}

环境变量

规则是前缀加驼峰配置名，适合 Docker 场景：

export GOPEED_ADDRESS="0.0.0.0"
export GOPEED_PORT="9999"
export GOPEED_USERNAME="gopeed"
export GOPEED_PASSWORD="你的密码"
export GOPEED_WHITEDOWNLOADDIRS="/root/downloads,/root/dir/*"

优先级与建议

三种方式同时存在时按实现优先级生效，日常建议「Docker 用环境变量、裸机常驻用 config.json、临时调试用命令行参数」。白名单字段与下载目录的关系见下载目录设置。

相关阅读

• 公网暴露前的加固：公网部署必开认证。