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

快速部署

方式一：docker-compose（推荐）

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

方式二：docker run

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`

示例：自定义密码

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 构建（可选）

如果需要自行构建镜像：

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

国内镜像加速

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

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

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

Nginx 反向代理

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

# 复制到 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