程序跑在 VPS 上,离不开各种配置:数据库连接地址、端口、账号密码、接口密钥、运行模式这些参数,决定了程序连哪、怎么跑。配置如果随手写在代码里、开发生产混在一起、敏感信息随意暴露,后面改起来麻烦,还容易出安全事故。这篇讲清 VPS 上的配置管理思路:配置写在哪、配置文件和环境变量怎么分工、开发和生产怎么分开、敏感信息怎么保管。

常见有三类位置:一类是程序目录下的配置文件,比如各类框架自带的 settings、config 文件,存放业务相关的参数;一类是环境变量,在系统或启动脚本里注入,程序启动时读取;还有一类是代码里写死的常量。规范做法是把可变参数从代码里抽出来,放进配置文件或环境变量,代码本身保持不变。
前面运行环境篇讲过 Node、Python、Java 的原生部署与版本管理;环境装好了,下一步就是把配置按规范接进去。配置和代码分开,后续换机器、改参数时才不用翻遍源码。
配置文件适合放相对固定、结构较复杂的参数,比如站点名称、路径规则、功能开关,可以写成结构化文件便于阅读和维护。环境变量适合放随环境变化、或敏感程度较高的参数,比如数据库口令、第三方密钥,通过启动环境注入,不落地在仓库文件里。
不少项目用 .env 文件集中管理环境变量,程序启动时自动读取。.env 里的内容通常不进版本库,避免口令跟着代码一起被提交。两种方式可以配合:公共参数放配置文件,环境相关和敏感参数走环境变量。
本地开发、测试、线上生产是不同环境,数据库地址、接口地址、调试开关往往不一样。最容易出问题的做法是同一份配置从头用到尾,本地调试开着的模式带到线上,或者线上配置被本地旧值覆盖。前面文件传输篇提醒过敏感配置不要整目录覆盖上传,原因就在这里。
规范做法是按环境分目录或分文件保存,线上用生产配置;需要切换环境时通过环境变量或配置加载顺序指定。部署前核对一遍当前生效的是哪份配置,改完重启对应服务再验证,避免“改了文件却没生效”或“生效的是另一份”。

数据库密码、API 密钥、访问令牌这类信息,不要直接写进会提交到代码仓库的文件,也不要放在公开可下载的目录里。优先用环境变量或本机受限权限的配置文件存放,文件权限只允许运行程序的账号读取。
配置文件里如果必须保留口令,确认它不在 Web 服务对外可访问的目录下;前面 Nginx 篇讲过站点目录绑定,配置和源码应放在站点根目录之外。发现口令泄露或怀疑外泄时,及时更换密钥,并检查是否有异常访问记录。
改配置前先备份原文件,记录改了什么、为什么改。一次只改一类相关参数,改完重启服务并按实际功能验证,出问题时好回退。配置里的地址、端口、路径要和实际部署对应,前面端口规划篇讲过内部端口与入口映射,配置里填的后端地址要和这套规划一致。
配置项命名和注释保持清楚,方便后续维护和交接。多人或多项目共用一台机器时,各项目配置独立存放,不要互相引用对方的口令和路径。
程序连不上数据库:先核对配置里的地址、端口、账号、库名是否正确,数据库是否只监听本机、Web 服务能否通过本机地址访问。接口调用失败:检查第三方密钥是否填对、是否过期、环境是否匹配。站点行为和预期不符:确认当前加载的是哪份配置、调试开关是否关闭。
排查时先看程序启动日志里读取到的配置来源和报错信息(前面进程服务篇讲过日志查看),再对照配置文件逐项核对,比凭猜测改参数更高效。
需要在同一台机器上跑多个项目、各自维护独立配置时,按项目数量和资源占用挑 justg RosCloud 系列,500Mbps 带宽:01 是 2 核 1G/20G/1TB,月付 19.99 美元;02 是 3 核 2G/40G/2TB,29.99 美元;03 是 4 核 4G/80G/3TB,39.99 美元;04 是 5 核 8G/160G/4TB,49.99 美元;05 是 6 核 16G/240G/5TB,59.99 美元;06 是 7 核 24G/320G/6TB,69.99 美元。项目和数据库并存时,优先选内存、磁盘更充足的档位。
想对照自己项目数量和配置挑选,可以看 justg 这条线,入口放这,点红色链接进去核对:
几句实在话:可变参数从代码里抽出来;固定参数放配置文件,敏感和环境相关参数走环境变量;开发生产配置分开,部署前核对生效版本;敏感口令不进仓库、不放在公开目录;改配置先备份、一次改一类、改完验证;配置项写清注释方便交接。
总的来讲,配置管理的原则是“代码与参数分离、环境之间隔离、敏感信息收敛”。把配置结构理顺,后续换机器、改参数、排查问题都会轻松很多,程序也能在不同环境下稳定、安全地运行。

游戏软件