网站跑起来之后,数据库密码总要有个地方存放。很多项目的做法是把密码直接写在代码里——config.php 里一行 $db_pass = "xxx";,然后提交到 Git 仓库。这种做法的风险在于:代码一旦泄露、仓库一旦被拖,密码就等于公开了;更糟的是密码还写进了历史提交,删也删不干净。
密码到底该放哪、怎么放,其实没有唯一答案,只有"按场景选合适的方式"。这篇文章会把常见的几种做法摆开来对比:环境变量、受限权限的配置文件、外部密钥管理服务,各自的优缺点和适用场景,然后落到几个真实可用的配置示例(MySQL 的 .my.cnf、PostgreSQL 的 .pgpass、systemd 的 EnvironmentFile),最后讲权限控制这个所有方案的共同底座。
读完你应该能根据自己项目的规模,选出合适的密码存储方式,并且知道每种方式需要注意的坑。文中不涉及任何具体厂商报价,涉及产品只用"主流云厂商"这类说法。
一、底线:密码不进代码、不进仓库
在讨论具体存储方式之前,有一条底线必须先立起来:密码不出现在源代码里,也不提交进版本控制。这条底线之所以重要,是因为代码的流动性太强了——它会被复制、被分享、被打包进镜像、被推到各种仓库,一旦密码混在里面,你根本不知道它已经扩散到了多少地方。
一个常见的补救手段是 .gitignore 加环境文件,但要注意历史提交问题。如果密码曾经被提交过,即使后来删了,它仍然留在 Git 历史里:
# 查看某文件历史上是否出现过敏感内容
git log -p --all -- config/database.yml | grep -i password
# 如果出现过,必须把密码当作已泄露处理:立即改密,再考虑重写历史
所以最重要的判断是:只要密码进过一次仓库,就应当认为它已经泄露,必须轮换。 修复仓库历史(如 git filter-repo)是补救,不是根本。
二、几种存储方式对比
把主流做法放在一起看,各自的定位会清晰很多:
| 方式 | 安全性 | 部署复杂度 | 适用场景 | 主要风险 |
|---|---|---|---|---|
| 明文写代码 | 极低 | 无 | 绝不推荐 | 泄露即全暴露 |
| 环境变量 | 中 | 低 | 容器化、单机服务 | 进程环境可被读取 |
| 受限权限配置文件 | 中高 | 低 | 传统单机应用 | 本机提权后可见 |
| 加密配置+启动解密 | 高 | 中 | 合规要求场景 | 密钥保管是难点 |
| KMS/Vault 密钥服务 | 高 | 中高 | 多服务、云环境 | 依赖外部服务可用性 |
| 容器 Secret | 中高 | 中 | 容器编排环境 | 与编排平台耦合 |
没有哪个是"绝对安全"的,选型要看你的规模:个人站点用受限权限配置文件就足够;小团队可以上环境变量或 systemd EnvironmentFile;有一定规模、多服务共享凭据时,才值得引入 KMS/Vault 这类集中管理。
三、环境变量:方便但有边界
环境变量是最流行的做法之一,尤其在容器和 12-Factor 风格的部署里。它的好处是代码里不硬编码,配置由运行时注入。
# 临时设置(仅当前会话)
export DB_PASSWORD='s3cr3t'
# systemd 服务中通过 EnvironmentFile 注入
# /etc/myapp/myapp.conf
DB_HOST=127.0.0.1
DB_USER=app
DB_PASSWORD=s3cr3t
# 记得收紧权限
chmod 600 /etc/myapp/myapp.conf
chown root:root /etc/myapp/myapp.conf
# /etc/systemd/system/myapp.service 片段
[Service]
EnvironmentFile=/etc/myapp/myapp.conf
ExecStart=/usr/local/bin/myapp
但环境变量有个常被忽略的问题:同机的其他进程有可能读到它。在 Linux 上,如果攻击者拿到本机的普通权限,通过 /proc/ 往往能读到目标进程的环境变量(取决于权限和内核配置)。
# 演示:某些情况下可读到进程环境变量
tr '\0' '\n' < /proc//environ | grep -i pass
这意味着环境变量适合"隔离性较好"的环境(比如独立容器),但如果你把数据库和一堆服务混跑在同一台机器上,它并不比一个 600 权限的配置文件更安全,甚至更差。另外,环境变量还容易随着日志、异常堆栈、docker inspect 等途径意外泄露,用的时候要留心。
四、受限权限配置文件:简单又实用
对传统单机应用,最实用的是"配置文件 + 严格权限"。核心动作只有一个:把文件权限收到只有运行服务的用户能读。
# 假设服务以 www-data 运行
chown www-data:www-data /var/www/app/.env
chmod 600 /var/www/app/.env # 仅属主可读写
# 确认权限
ls -l /var/www/app/.env
# -rw------- 1 www-data www-data ...
目录权限也要一并收紧,否则别人能进目录、能列举文件名,仍是不必要的暴露。不过要提醒的是,如果攻击者已经拿到 root,任何本机文件都保护不了,此时能救你的只有"密码不在本机"(即 KMS/Vault 方案)或者"及时轮换密码"。
数据库客户端自己也支持从配置文件读密码,这在脚本和运维里非常实用。MySQL 和 PostgreSQL 各有约定:
# MySQL / MariaDB:~/.my.cnf(或 /etc/my.cnf.d/xxx.cnf)
[client]
user = app
password = s3cr3t
host = 127.0.0.1
# 权限必须 600,否则 MySQL 会告警甚至拒绝使用
# PostgreSQL:~/.pgpass,格式为 主机:端口:库:用户:密码
echo "127.0.0.1:5432:appdb:app:s3cr3t" > ~/.pgpass
chmod 600 ~/.pgpass
.pgpass 只允许属主读写,权限不对 PostgreSQL 会直接忽略它。这类文件的共同要求都是 chmod 600,原因是数据库客户端会检查权限,避免密码被同机其他用户读到。
五、更彻底的方案:让密码不落在本机
如果应用规模变大、服务变多,"每台机器上都存一份密码"就开始变得难以管理:改一次密码要改 N 个地方,任何一台机器被攻破都会泄露。这时可以考虑集中式的密钥管理。
一种思路是用主流云厂商提供的密钥管理服务(KMS):把密码加密存起来,应用启动时用有权限的凭据去解密获取;另一种是自建 Vault 类服务,把密码集中托管,应用通过短时令牌按需拉取,并且可以做到"审计每次读取""自动轮换"。这类方案的优势是把密码的"存储"和"使用"分离,机器上不落地明文。
代价是复杂度上升:引入了外部依赖(服务不可用时应用可能起不来)、需要管理访问凭据、要规划网络与高可用。所以在小规模场景里通常不划算,等你有多个服务需要共享同一批凭据、或者有合规要求时再上更合适。
容器环境里还有一层选择:编排平台提供的 Secret 机制。它把敏感数据与镜像分离,运行时以文件或环境变量形式挂进容器。相比把密码打进镜像,这是明显的进步,但它同样与平台深度绑定,需要按平台的规范管理,且要注意"Secret 不能明文提交进编排清单"。
六、权限控制是所有方案的共同底座
无论选哪种存储方式,权限控制都是绕不开的一环。几个通用原则:
第一,最小权限。运行服务的系统用户不应该拥有超出需要的权限,数据库账号也应该只授予业务真正用到的库和表权限,而不是动辄 GRANT ALL。
-- MySQL:只授予必要权限,而不是 ALL PRIVILEGES
CREATE USER 'app'@'127.0.0.1' IDENTIFIED BY 's3cr3t';
GRANT SELECT, INSERT, UPDATE, DELETE ON appdb.* TO 'app'@'127.0.0.1';
FLUSH PRIVILEGES;
第二,限制来源。数据库账号限定从 127.0.0.1 或内网地址连接,不要让 'app'@'%' 暴露给全网。
第三,定期轮换。再安全的存储也挡不住"用久了被慢慢摸清",重要凭据建议按周期(如 90 天,经验值)轮换一次。
第四,隔离读写。备份、报表这类只读用途应使用只读账号;应用账号不要同时拥有 DROP、FILE 等高危权限。
| 权限控制措施 | 具体做法 | 解决的问题 |
|---|---|---|
| 文件权限 600 | chmod 600、属主限定服务用户 |
同机用户读不到 |
| 目录权限收紧 | 目录 750/700 |
防止列举与遍历 |
| 数据库最小授权 | 按需 GRANT,不用 ALL |
单点泄露危害面小 |
| 限定连接来源 | @'127.0.0.1' 或内网段 |
防远程直连爆破 |
| 定期轮换 | 90 天一轮换 | 缩短泄露窗口 |
常见问题
Q:环境变量和配置文件,到底选哪个?
A:隔离较好的容器环境用环境变量更方便;同机混跑多个服务时,600 权限的配置文件往往更可控。两者都不是"绝对安全",关键看同机谁能读到。
Q:密码放在 600 权限文件里,还需要加密吗?
A:如果攻击者只是普通用户,600 已经够用;如果担心被 root 读取,加密文件意义有限(启动解密的密钥也在本机),这种场景更适合外部 KMS/Vault。
Q:.pgpass 权限对了还是不生效?
A:检查格式(五段冒号分隔)、位置(家目录)、以及是否用对了用户。PostgreSQL 会静默忽略权限不符的文件。
Q:代码里曾经提交过密码,删掉就行了吗?
A:不行。Git 历史仍保留记录,应视为已泄露,立即轮换密码,再评估是否重写历史。
Q:小项目有必要上 Vault 吗?
A:通常没有必要。一台机器、一个应用,用 600 权限的配置文件或 systemd EnvironmentFile 就够了。集中密钥管理在"多服务共享凭据、需要审计与轮换"时才体现价值。
总结
- 底线是密码不进代码、不进仓库;一旦进过仓库就视为泄露,必须轮换而不是只删文件。
- 存储方式按规模选:单机用 600 权限配置文件,容器用环境变量或容器 Secret,多服务共享凭据再上 KMS/Vault。
- 环境变量并非绝对安全,同机的
/proc/可能读到;隔离度差的环境优先用受限权限文件。/environ - 数据库客户端自带的
.my.cnf、.pgpass都要求chmod 600,权限不对会被忽略,这是最容易踩的坑。 - 权限控制是共同底座:最小授权、限定连接来源、定期轮换、读写隔离,任何存储方案都离不开这几条。
企业QQ咨询




