生产检查清单

将应用部署到生产环境前的检查清单。

安全概念

安全架构和核心特性详见安全概述。

部署前检查

文件安全

[ ] .env.production 文件存在
[ ] 文件权限为 600 或更严格
[ ] 敏感文件已添加到 .gitignore
[ ] 配置文件不含占位符（如 change-me、xxx）

bash

# 检查权限
ls -la .env.production
# 应显示: -rw------- (600)

# 修复权限
chmod 600 .env.production

配置验证

[ ] 所有必需键已设置
[ ] 敏感值不为空
[ ] 值格式正确（URL、端口等）
[ ] 无硬编码密钥

cfg := env.ProductionConfig()
cfg.RequiredKeys = []string{
    "DB_HOST", "DB_PORT", "DB_USER", "DB_PASSWORD",
    "API_KEY", "API_URL",
}
cfg.FailOnMissingFile = true

安全配置检查

审计日志

[ ] 审计日志已启用
[ ] 日志目录可写
[ ] 日志文件权限正确

auditFile, err := os.OpenFile("/var/log/app/audit.log",
    os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0600)
if err != nil {
    log.Fatalf("打开审计日志失败: %v", err)
}
cfg.AuditEnabled = true
cfg.AuditHandler = env.NewJSONAuditHandler(auditFile)

「已启用」≠「已落盘」

ProductionConfig() 默认 AuditEnabled = true；未配置 AuditHandler 时，审计事件走 stderr 的 [AUDIT] 标准日志而非文件。上线后应确认审计日志文件确实在增长。

敏感数据处理

[ ] 敏感值使用 GetSecure 获取
[ ] 及时调用 Release() 释放资源（清零并归还对象池；Close() 不归还池）
[ ] 日志不输出原始敏感值

secret := loader.GetSecure("DB_PASSWORD")
defer secret.Release()
log.Printf("Password length: %d", secret.Length())

访问控制

[ ] 设置 AllowedKeys 白名单（推荐）
[ ] 启用 ValidateValues
[ ] 合理设置大小限制
[ ] 配置文件路径均为相对路径——Filenames 拒绝绝对路径、UNC 路径、URL 编码 % 与 .. 目录穿越
[ ] 配置来源不可信时设置 ExpansionScope: ExpansionFileOnly，防止 .env 展开捕获进程机密（SEC-03）
[ ] 审计 handler 不接 os.Stdout——loader.Close() 会关闭处理器并连带关闭底层 writer

cfg.AllowedKeys = []string{"APP_NAME", "DB_HOST", "API_KEY"}
cfg.ValidateValues = true
cfg.MaxVariables = 50 // ProductionConfig 默认即为 50，仅在键更多时调高

部署时检查

[ ] 配置文件从安全位置加载
[ ] 应用启动时验证配置
[ ] 配置错误时应用拒绝启动
[ ] 敏感信息不输出到日志

部署后检查

[ ] 应用正常运行
[ ] 审计日志正常写入
[ ] 无敏感信息泄露
[ ] 监控配置相关错误

bash

# 健康检查：确认应用存活
curl -fsS http://localhost:8080/healthz > /dev/null && echo "OK: health check passed"

# 确认审计日志确实落盘（而非仅 stderr [AUDIT] 兜底输出）
tail -n 5 /var/log/app/audit.log

快速检查脚本

bash

#!/bin/bash
# pre-deploy-check.sh

set -e

echo "=== Pre-deployment Config Check ==="

# 检查文件存在
[ -f ".env.production" ] || { echo "ERROR: .env.production not found"; exit 1; }

# 检查权限
PERMS=$(stat -c %a .env.production 2>/dev/null || stat -f %Lp .env.production)
[ "$PERMS" = "600" ] || [ "$PERMS" = "400" ] || echo "WARNING: permissions are $PERMS"

# 检查占位符
grep -qE "(change-?me|placeholder|xxx|YOUR_)" .env.production && \
    { echo "ERROR: Found placeholder values"; exit 1; }

# 检查必需键
for key in DB_HOST DB_PORT DB_USER DB_PASSWORD API_KEY; do
    grep -q "^$key=" .env.production || { echo "ERROR: Missing $key"; exit 1; }
done

echo "=== All checks passed ==="

生产检查清单 ​

部署前检查 ​

文件安全 ​

配置验证 ​

安全配置检查 ​

审计日志 ​

敏感数据处理 ​

访问控制 ​

部署时检查 ​

部署后检查 ​

快速检查脚本 ​

相关文档 ​

生产检查清单

部署前检查

文件安全

配置验证

安全配置检查

审计日志

敏感数据处理

访问控制

部署时检查

部署后检查

快速检查脚本

相关文档