# 文档管理系统 v1.1 - Docker 部署指南

## 快速部署

### 方式一：docker-compose（推荐）

```bash
# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down
```

### 方式二：docker run

```bash
docker run -d \
  --name doc-manager \
  -p 3344:3344 \
  -v $(pwd)/uploads:/app/uploads \
  -v $(pwd)/data:/app/data \
  --restart unless-stopped \
  doc-manager:v1.1
```

## 访问地址

- 管理后台：`http://your-server-ip:3344`
- 默认超级管理员：`gwalrusadmin` / `admin123`

## 环境变量配置

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `PORT` | 服务端口 | `3344` |
| `BASE_URL` | 外网访问地址 | 自动检测 |
| `ADMIN_PASSWORD` | 超级管理员密码 | `admin123` |
| `USERS` | 其他用户 | - |
| `SALT` | 密码加密盐 | `docmgr-salt-2026` |
| `SESSION_SECRET` | Session 密钥 | 随机生成 |

### 示例：自定义密码

```bash
docker run -d \
  --name doc-manager \
  -p 3344:3344 \
  -e ADMIN_PASSWORD=my-secure-password \
  -v $(pwd)/uploads:/app/uploads \
  -v $(pwd)/data:/app/data \
  doc-manager:v1.1
```

## 数据持久化

两个挂载卷：
- `./uploads` - 上传的文件
- `./data` - SQLite 数据库

## Docker 构建（可选）

如果需要自行构建镜像：

```bash
docker build -t doc-manager:v1.1 .
```

### 国内镜像加速

如果构建速度慢，可以在 Dockerfile 中使用以下加速器：

```dockerfile
# Docker 镜像加速器（可选）
# https://c9e63rgs.mirror.aliyuncs.com
```

或在 Docker Desktop 设置中添加镜像加速器。

## Nginx 反向代理

项目已提供 `nginx.conf`，域名 `q.gwalrus.com`：

```bash
# 复制到 nginx 配置目录
sudo cp nginx.conf /etc/nginx/conf.d/q.gwalrus.com.conf

# 测试配置
sudo nginx -t

# 重载
sudo nginx -s reload

# HTTPS（推荐）
sudo certbot --nginx -d q.gwalrus.com
```

## 版本信息

- **版本**: v1.1
- **安全加固**: bcrypt 密码加密 + 速率限制 + 文件类型白名单
- **数据库**: SQLite (better-sqlite3)
- **基础镜像**: node:20-alpine
- **镜像大小**: ~177MB