Dujiao-Next部署：脚本化保姆级教程

本文地址：/posts/dujiao-next-docker-compose-deploy-2026/

这篇文章基于 Dujiao-Next 官方文档的 Docker Compose 方案整理，目标是“每一步一段脚本”，照着敲就能搭好。项目地址https://dujiao-next.com

Dujiao-Next 部署流程图

Dujiao-Next 架构示意

部署前准备#

一台 Linux 服务器与可解析到公网 IP 的域名
已安装 Docker 与 Docker Compose
规划端口：至少 API 端口 + Web 端口
选择数据方案：轻量用 SQLite + Redis；生产建议 PostgreSQL + Redis
必须改强随机密钥：jwt.secret 与 user_jwt.secret

脚本 1：创建部署目录并修正权限#

1
sudo mkdir -p /opt/dujiao-next/{config,data/db,data/uploads,data/logs,data/redis,data/postgres}
2
cd /opt/dujiao-next
3

4
# 避免日志/数据库目录权限不足（API 容器默认非 root 用户）
5
sudo chmod -R 0777 ./data/logs ./data/db ./data/uploads ./data/redis ./data/postgres

脚本 2：下载 API 配置模板#

1
cd /opt/dujiao-next
2
sudo curl -L https://raw.githubusercontent.com/dujiao-next/dujiao-next/main/config.yml.example -o ./config/config.yml

脚本 3：编辑 `config.yml`#

1
sudo nano /opt/dujiao-next/config/config.yml

把数据库和 Redis 配置改为下面示例（SQLite + Redis），并务必修改 jwt.secret 与 user_jwt.secret 为强随机字符串：

1
database:
2
  driver: sqlite
3
  dsn: /app/db/dujiao.db
4

5
redis:
6
  enabled: true
7
  host: redis
8
  port: 6379
9
  password: your-strong-redis-password
10
  db: 0
11
  prefix: "dj"
12

13
queue:
14
  enabled: true
15
  host: redis
16
  port: 6379
17
  password: your-strong-redis-password
18
  db: 1
19
  concurrency: 10
20
  queues:
21
    default: 10
22
    critical: 5

脚本 4：写入 `.env`#

1
cat > /opt/dujiao-next/.env <<'ENV'
2
TAG=latest
3
TZ=Asia/Shanghai
4

5
API_PORT=8080
6
USER_PORT=8081
7
ADMIN_PORT=8082
8
REDIS_PORT=6379
9
POSTGRES_PORT=5432
10

11
# 默认管理员（仅首次初始化时生效）
12
DJ_DEFAULT_ADMIN_USERNAME=admin
13
DJ_DEFAULT_ADMIN_PASSWORD=admin123
14

15
# Redis
16
REDIS_PASSWORD=your-strong-redis-password
17

18
# PostgreSQL（仅 PostgreSQL 方案需要）
19
POSTGRES_DB=dujiao_next
20
POSTGRES_USER=dujiao
21
POSTGRES_PASSWORD=dujiao_pass
22
ENV

脚本 5：写入 Compose 文件（SQLite + Redis）#

1
cat > /opt/dujiao-next/docker-compose.sqlite.yml <<'YAML'
2
services:
3
  redis:
4
    image: redis:7-alpine
5
    container_name: dujiaonext-redis
6
    restart: unless-stopped
7
    environment:
8
      REDIS_PASSWORD: ${REDIS_PASSWORD}
9
    command: ["redis-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD}"]
10
    ports:
11
      - "${REDIS_PORT}:6379"
12
    volumes:
13
      - ./data/redis:/data
14
    healthcheck:
15
      test: ["CMD", "redis-cli", "-a", "${REDIS_PASSWORD}", "ping"]
16
      interval: 10s
17
      timeout: 3s
18
      retries: 10
19
    networks:
20
      - dujiao-net
21

22
  api:
23
    image: dujiaonext/api:${TAG}
24
    container_name: dujiaonext-api
25
    restart: unless-stopped
26
    environment:
27
      TZ: ${TZ}
28
      DJ_DEFAULT_ADMIN_USERNAME: ${DJ_DEFAULT_ADMIN_USERNAME}
29
      DJ_DEFAULT_ADMIN_PASSWORD: ${DJ_DEFAULT_ADMIN_PASSWORD}
30
    ports:
31
      - "${API_PORT}:8080"
32
    volumes:
33
      - ./config/config.yml:/app/config.yml:ro
34
      - ./data/db:/app/db
35
      - ./data/uploads:/app/uploads
36
      - ./data/logs:/app/logs
37
    depends_on:
38
      redis:
39
        condition: service_healthy
40
    healthcheck:
41
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8080/health"]
42
      interval: 10s
43
      timeout: 3s
44
      retries: 10
45
    networks:
46
      - dujiao-net
47

48
  user:
49
    image: dujiaonext/user:${TAG}
50
    container_name: dujiaonext-user
51
    restart: unless-stopped
52
    environment:
53
      TZ: ${TZ}
54
    ports:
55
      - "${USER_PORT}:80"
56
    depends_on:
57
      api:
58
        condition: service_healthy
59
    networks:
60
      - dujiao-net
61

62
  admin:
63
    image: dujiaonext/admin:${TAG}
64
    container_name: dujiaonext-admin
65
    restart: unless-stopped
66
    environment:
67
      TZ: ${TZ}
68
    ports:
69
      - "${ADMIN_PORT}:80"
70
    depends_on:
71
      api:
72
        condition: service_healthy
73
    networks:
74
      - dujiao-net
75

76
networks:
77
  dujiao-net:
78
    driver: bridge
79
YAML

脚本 6：启动服务#

1
cd /opt/dujiao-next
2
docker compose --env-file .env -f docker-compose.sqlite.yml up -d

脚本 7：健康检查与首次登录#

1
docker compose --env-file .env -f docker-compose.sqlite.yml ps
2
curl -fsS http://127.0.0.1:8080/health

本地访问：

前台：http://服务器IP:8081
后台：http://服务器IP:8082

默认后台管理员（首次初始化时生效）：

账号：admin
密码：admin123

脚本 8：Nginx 反向代理（可选，推荐上生产）#

如果你要用域名访问，且前台/后台走同源 /api 与 /uploads，可以用如下示例：

1
sudo tee /etc/nginx/conf.d/dujiao-next.conf > /dev/null <<'NGINX'
2
server {
3
    listen 80;
4
    server_name user.example.com;
5

6
    location / {
7
        proxy_pass http://127.0.0.1:8081;
8
        proxy_set_header Host $host;
9
        proxy_set_header X-Real-IP $remote_addr;
10
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
11
        proxy_set_header X-Forwarded-Proto $scheme;
12
    }
13

14
    location /api/ {
15
        proxy_pass http://127.0.0.1:8080/;
16
        proxy_set_header Host $host;
17
        proxy_set_header X-Real-IP $remote_addr;
18
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
19
        proxy_set_header X-Forwarded-Proto $scheme;
20
    }
21

22
    location /uploads/ {
23
        proxy_pass http://127.0.0.1:8080/uploads/;
24
        proxy_set_header Host $host;
25
        proxy_set_header X-Real-IP $remote_addr;
26
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
27
        proxy_set_header X-Forwarded-Proto $scheme;
28
    }
29
}
30

31
server {
32
    listen 80;
33
    server_name admin.example.com;
34

35
    location / {
36
        proxy_pass http://127.0.0.1:8082;
37
        proxy_set_header Host $host;
38
        proxy_set_header X-Real-IP $remote_addr;
39
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
40
        proxy_set_header X-Forwarded-Proto $scheme;
41
    }
42

43
    location /api/ {
44
        proxy_pass http://127.0.0.1:8080/;
45
        proxy_set_header Host $host;
46
        proxy_set_header X-Real-IP $remote_addr;
47
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
48
        proxy_set_header X-Forwarded-Proto $scheme;
49
    }
50

51
    location /uploads/ {
52
        proxy_pass http://127.0.0.1:8080/uploads/;
53
        proxy_set_header Host $host;
54
        proxy_set_header X-Real-IP $remote_addr;
55
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
56
        proxy_set_header X-Forwarded-Proto $scheme;
57
    }
58
}
59
NGINX
60

61
sudo nginx -t
62
sudo systemctl reload nginx

如果你要 PostgreSQL#

把 config.yml 的 database.driver 改成 postgres，并按文档填 dsn
把 Compose 文件换成 docker-compose.postgres.yml 并启动对应命令

无脑指令（SQLite + Redis，一条指令搞定）：

1
sudo bash -c 'set -e
2
BASE=/opt/dujiao-next
3
mkdir -p $BASE/{config,data/db,data/uploads,data/logs,data/redis}
4
chmod -R 0777 $BASE/data/logs $BASE/data/db $BASE/data/uploads $BASE/data/redis
5
curl -fsSL https://raw.githubusercontent.com/dujiao-next/dujiao-next/main/config.yml.example -o $BASE/config/config.yml
6
sed -i "s#dsn: ./db/dujiao.db#dsn: /app/db/dujiao.db#" $BASE/config/config.yml
7
sed -i "s#host: 127.0.0.1#host: redis#g" $BASE/config/config.yml
8
sed -i "s#password: \"\"#password: your-strong-redis-password#g" $BASE/config/config.yml
9
cat > $BASE/.env <<EOF
10
TAG=latest
11
TZ=Asia/Shanghai
12
API_PORT=8080
13
USER_PORT=8081
14
ADMIN_PORT=8082
15
REDIS_PORT=6379
16
DJ_DEFAULT_ADMIN_USERNAME=admin
17
DJ_DEFAULT_ADMIN_PASSWORD=admin123
18
REDIS_PASSWORD=your-strong-redis-password
19
EOF
20
cat > $BASE/docker-compose.sqlite.yml <<EOF
21
services:
22
  redis:
23
    image: redis:7-alpine
24
    container_name: dujiaonext-redis
25
    restart: unless-stopped
26
    environment:
27
      REDIS_PASSWORD: \${REDIS_PASSWORD}
28
    command: ["redis-server", "--appendonly", "yes", "--requirepass", "\${REDIS_PASSWORD}"]
29
    ports:
30
      - "\${REDIS_PORT}:6379"
31
    volumes:
32
      - ./data/redis:/data
33
    healthcheck:
34
      test: ["CMD", "redis-cli", "-a", "\${REDIS_PASSWORD}", "ping"]
35
      interval: 10s
36
      timeout: 3s
37
      retries: 10
38
    networks:
39
      - dujiao-net
40
  api:
41
    image: dujiaonext/api:\${TAG}
42
    container_name: dujiaonext-api
43
    restart: unless-stopped
44
    environment:
45
      TZ: \${TZ}
46
      DJ_DEFAULT_ADMIN_USERNAME: \${DJ_DEFAULT_ADMIN_USERNAME}
47
      DJ_DEFAULT_ADMIN_PASSWORD: \${DJ_DEFAULT_ADMIN_PASSWORD}
48
    ports:
49
      - "\${API_PORT}:8080"
50
    volumes:
51
      - ./config/config.yml:/app/config.yml:ro
52
      - ./data/db:/app/db
53
      - ./data/uploads:/app/uploads
54
      - ./data/logs:/app/logs
55
    depends_on:
56
      redis:
57
        condition: service_healthy
58
    healthcheck:
59
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8080/health"]
60
      interval: 10s
61
      timeout: 3s
62
      retries: 10
63
    networks:
64
      - dujiao-net
65
  user:
66
    image: dujiaonext/user:\${TAG}
67
    container_name: dujiaonext-user
68
    restart: unless-stopped
69
    environment:
70
      TZ: \${TZ}
71
    ports:
72
      - "\${USER_PORT}:80"
73
    depends_on:
74
      api:
75
        condition: service_healthy
76
    networks:
77
      - dujiao-net
78
  admin:
79
    image: dujiaonext/admin:\${TAG}
80
    container_name: dujiaonext-admin
81
    restart: unless-stopped
82
    environment:
83
      TZ: \${TZ}
84
    ports:
85
      - "\${ADMIN_PORT}:80"
86
    depends_on:
87
      api:
88
        condition: service_healthy
89
    networks:
90
      - dujiao-net
91
networks:
92
  dujiao-net:
93
    driver: bridge
94
EOF
95
cd $BASE
96
docker compose --env-file .env -f docker-compose.sqlite.yml up -d'