201 lines
5.1 KiB
Markdown
201 lines
5.1 KiB
Markdown
# 安全加固
|
||
|
||
## 概述
|
||
|
||
生产环境的安全加固是防止数据泄露和服务被攻击的关键措施。本文从应用配置、传输安全、访问控制、数据保护等维度介绍安全加固实践。
|
||
|
||
:::tip 安全原则
|
||
- 最小权限：只开放必要的端口和权限
|
||
- 纵深防御：多层安全措施叠加
|
||
- 默认安全：配置默认值应为安全选项
|
||
:::
|
||
|
||
## 应用层安全
|
||
|
||
### 关闭 DEBUG 模式
|
||
|
||
```bash
|
||
# .env 生产环境配置
|
||
FASTAPI_DEBUG=False
|
||
```
|
||
|
||
:::warning 重要
|
||
DEBUG 模式会暴露详细的错误堆栈、SQL 查询等敏感信息，生产环境必须关闭。
|
||
:::
|
||
|
||
### JWT 安全
|
||
|
||
```bash
|
||
# .env 配置
|
||
JWT_SALT=<随机生成的64位强密码>
|
||
JWT_EXPIRE_MINUTES=720
|
||
```
|
||
|
||
```bash
|
||
# 生成强密码
|
||
python -c "import secrets; print(secrets.token_urlsafe(48))"
|
||
```
|
||
|
||
:::tip JWT 安全要点
|
||
1. `JWT_SALT` 必须使用随机强密码，禁止使用默认值
|
||
2. 不同环境使用不同的 `JWT_SALT`
|
||
3. 定期轮换 `JWT_SALT`（需同时使所有已发 token 失效）
|
||
4. token 过期时间不宜过长，建议 12 小时以内
|
||
:::
|
||
|
||
### 演示模式
|
||
|
||
```bash
|
||
# 演示环境：禁止写操作
|
||
FASTAPI_DEMO=True
|
||
```
|
||
|
||
演示模式下所有写操作（新增/编辑/删除/状态变更/导入/导出）都会被 `@check_demo` 装饰器拦截。
|
||
|
||
## CORS 配置
|
||
|
||
```python
|
||
# core/config/app.py 中配置
|
||
CORS_ORIGINS = [
|
||
"https://www.example.com",
|
||
"https://admin.example.com",
|
||
]
|
||
```
|
||
|
||
:::warning CORS 安全
|
||
- 生产环境禁止使用 `allow_origins=["*"]`（允许任意来源）
|
||
- 仅列出信任的前端域名
|
||
- 如需支持多子域，使用正则匹配而非通配符
|
||
:::
|
||
|
||
## .env 文件安全
|
||
|
||
### 文件权限
|
||
|
||
```bash
|
||
# 设置 .env 文件权限（仅运行用户可读写）
|
||
chmod 600 .env
|
||
|
||
# 查看权限
|
||
ls -la .env
|
||
# -rw------- 1 app app 1024 Sep 5 10:00 .env
|
||
```
|
||
|
||
### 敏感信息管理
|
||
|
||
```bash
|
||
# .env 中的敏感字段
|
||
DB_PASS=<数据库密码>
|
||
REDIS_PASSWORD=<Redis密码>
|
||
JWT_SALT=<JWT密钥>
|
||
```
|
||
|
||
:::tip 安全建议
|
||
1. `.env` 文件禁止提交到 Git（已在 `.gitignore` 中排除）
|
||
2. 不同环境的 `.env` 独立管理，禁止共用
|
||
3. 生产环境密码至少 16 位，包含大小写字母、数字、特殊字符
|
||
4. 定期轮换数据库密码和 JWT 密钥
|
||
:::
|
||
|
||
## 数据库安全
|
||
|
||
### MySQL 安全配置
|
||
|
||
```sql
|
||
-- 创建专用数据库用户（禁止使用 root）
|
||
CREATE USER 'djangoadmin'@'%' IDENTIFIED BY '<强密码>';
|
||
GRANT SELECT, INSERT, UPDATE, DELETE ON djangoadmin_prod.* TO 'djangoadmin'@'%';
|
||
FLUSH PRIVILEGES;
|
||
|
||
-- 禁止远程 root 登录
|
||
DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost', '127.0.0.1');
|
||
FLUSH PRIVILEGES;
|
||
```
|
||
|
||
:::tip 最小权限原则
|
||
应用数据库用户只需 SELECT/INSERT/UPDATE/DELETE 权限，禁止 GRANT/CREATE/DROP 等管理权限。
|
||
:::
|
||
|
||
### Redis 安全
|
||
|
||
```bash
|
||
# redis.conf 安全配置
|
||
# 设置密码
|
||
requirepass <强密码>
|
||
|
||
# 禁止危险命令
|
||
rename-command FLUSHDB ""
|
||
rename-command FLUSHALL ""
|
||
rename-command CONFIG ""
|
||
rename-command DEBUG ""
|
||
|
||
# 绑定地址
|
||
bind 127.0.0.1
|
||
|
||
# 禁用 protected-mode（设置了密码后）
|
||
protected-mode no
|
||
```
|
||
|
||
## 防火墙配置
|
||
|
||
### iptables 基础规则
|
||
|
||
```bash
|
||
# 仅开放必要端口
|
||
iptables -A INPUT -p tcp --dport 22 -j ACCEPT # SSH
|
||
iptables -A INPUT -p tcp --dport 80 -j ACCEPT # HTTP
|
||
iptables -A INPUT -p tcp --dport 443 -j ACCEPT # HTTPS
|
||
iptables -A INPUT -p tcp --dport 8031 -j ACCEPT # FastAPI（如不走 Nginx）
|
||
iptables -A INPUT -i lo -j ACCEPT # 本地回环
|
||
iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
|
||
iptables -P INPUT DROP # 默认拒绝
|
||
|
||
# 保存规则
|
||
iptables-save > /etc/iptables/rules.v4
|
||
```
|
||
|
||
:::tip 端口规划
|
||
| 端口 | 服务 | 是否对外 | 备注 |
|
||
|------|------|---------|------|
|
||
| 22 | SSH | 是（限制 IP） | 建议修改默认端口 |
|
||
| 80 | Nginx HTTP | 是 | 跳转 HTTPS |
|
||
| 443 | Nginx HTTPS | 是 | 主入口 |
|
||
| 8031 | FastAPI | 否 | 仅 Nginx 可访问 |
|
||
| 3306 | MySQL | 否 | 仅应用可访问 |
|
||
| 6379 | Redis | 否 | 仅应用可访问 |
|
||
:::
|
||
|
||
## 上传文件安全
|
||
|
||
```python
|
||
# 文件类型白名单
|
||
ALLOWED_EXTENSIONS = {'.jpg', '.jpeg', '.png', '.gif', '.pdf', '.doc', '.docx', '.xls', '.xlsx'}
|
||
|
||
# 文件大小限制
|
||
MAX_FILE_SIZE = 10 * 1024 * 1024 # 10MB
|
||
```
|
||
|
||
:::tip 文件安全措施
|
||
1. 上传文件重命名为 UUID，防止路径遍历攻击
|
||
2. 验证文件类型（检查文件头，不依赖扩展名）
|
||
3. 上传目录禁止执行权限
|
||
4. 图片文件重新编码（防止嵌入恶意代码）
|
||
:::
|
||
|
||
## 安全检查清单
|
||
|
||
- [ ] `FASTAPI_DEBUG=False`
|
||
- [ ] `JWT_SALT` 使用随机强密码
|
||
- [ ] `.env` 文件权限 `600`
|
||
- [ ] CORS 不使用 `*` 通配符
|
||
- [ ] 数据库用户非 root 且最小权限
|
||
- [ ] Redis 设置密码并禁用危险命令
|
||
- [ ] 防火墙仅开放必要端口
|
||
- [ ] 上传文件类型白名单验证
|
||
- [ ] 日志不记录敏感信息（密码、token）
|
||
- [ ] HTTPS 启用且禁用 TLSv1.0/1.1
|
||
|
||
## 总结
|
||
|
||
安全加固的核心是纵深防御：应用层关闭 DEBUG、配置强 JWT 密钥、限制 CORS；数据层数据库最小权限、Redis 密码保护；网络层防火墙仅开放必要端口；文件层上传白名单验证。生产环境务必逐项检查安全清单，定期审计。
|