qunl-api Linux 服务器 Docker 部署保姆级教程

1
# 1. 更新系统软件包（可选，建议新服务器执行）
2
yum update -y
3

4
# 2. 安装 Docker 所需的基础系统工具
5
yum install -y yum-utils device-mapper-persistent-data lvm2
6

7
# 3. 设置阿里云官方的 Docker Yum 源（国内服务器加速）
8
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
9

10
# 4. 安装 Docker 社区版
11
yum install -y docker-ce docker-ce-cli containerd.io
12

13
# 5. 启动 Docker 服务并设置开机自启
14
systemctl start docker
15
systemctl enable docker
16

17
# 6. 验证 Docker 是否安装成功
18
docker version

1
# ==========================================
2
# 1. 环境彻底清理
3
# ==========================================
4
docker stop pg15 redis7 nginx-proxy && docker rm pg15 redis7 nginx-proxy
5
rm -rf /data/postgres /data/redis /data/nginx/conf.d
6

7
# ==========================================
8
# 2. 启动全新 PostgreSQL 15（密码：BbAxy_110goodpg）
9
# ==========================================
10
docker run --name pg15 \
11
  -e POSTGRES_USER=root \
12
  -e POSTGRES_PASSWORD=BbAxy_110goodpg \
13
  -v /data/postgres:/var/lib/postgresql/data \
14
  -p 5432:5432 \
15
  -d postgres:15
16

17
# ==========================================
18
# 3. 启动全新 Redis 7（密码：BbAxy_110goodredis）
19
# ==========================================
20
docker run --name redis7 \
21
  -p 6379:6379 \
22
  -v /data/redis:/data \
23
  -d redis:7.2 \
24
  redis-server --appendonly yes --requirepass BbAxy_110goodredis
25

26
# ==========================================
27
# 4. 配置并启动 Nginx 反向代理（映射 80 端口）
28
# ==========================================
29
mkdir -p /data/nginx/conf.d
30

31
cat << 'EOF' > /data/nginx/conf.d/qunl_api.conf
32
server {
33
    listen 80;
34
    server_name localhost;
35

36
    location / {
37
        proxy_pass http://host.docker.internal:6000;
38
        proxy_set_header Host $host;
39
        proxy_set_header X-Real-IP $remote_addr;
40
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
41
        proxy_set_header X-Forwarded-Proto $scheme;
42

43
        # 支持 WebSocket 流式传输
44
        proxy_http_version 1.1;
45
        proxy_set_header Upgrade $http_upgrade;
46
        proxy_set_header Connection "upgrade";
47
    }
48
}
49
EOF
50

51
docker run --name nginx-proxy \
52
  -p 80:80 \
53
  -v /data/nginx/conf.d:/etc/nginx/conf.d:ro \
54
  --add-host=host.docker.internal:host-gateway \
55
  -d nginx:latest

1
cat << 'EOF' > .env
2
# 端口号
3
PORT=3000
4
# 前端基础URL（留空则使用本机嵌入的 WEB 页面；设为其他域名则访问本机时会被重定向到该地址，易导致白屏）
5
# FRONTEND_BASE_URL=
6
FRONTEND_BASE_URL=
7
REGISTER_DEFAULT_GROUP=default
8
# 调试相关配置
9
# 启用pprof
10
# ENABLE_PPROF=true
11
# 启用调试模式
12
DEBUG=true
13

14
# 数据库相关配置
15
SQL_DSN=postgres://root:BbAxy_110goodpg@127.0.0.1:5432/qunl_api?sslmode=disable
16
LOG_SQL_DSN=postgres://root:BbAxy_110goodpg@127.0.0.1:5432/qunl_api-logs?sslmode=disable
17
REDIS_CONN_STRING=redis://:BbAxy_110goodredis@127.0.0.1:6379/0
18
LOG_REQUEST_RESPONSE_ENABLED=true
19

20

21

22
# PostgreSQL 格式：postgresql://user:password@host:port/dbname（密码含 @ 等需 URL 编码，如 @ → %40）
23
# MySQL 格式：user:password@tcp(host:port)/dbname?parseTime=true
24
#SQL_DSN=postgresql://root:new_API%402025@data.qunl.com:14421/new-api
25
# 日志数据库
26
#LOG_SQL_DSN=postgresql://root:new_API%402025@data.qunl.com:14421/new-api-logs
27
# SQLite数据库路径
28
# SQLITE_PATH=/path/to/sqlite.db
29
# 数据库最大空闲连接数
30
# SQL_MAX_IDLE_CONNS=100
31
# 数据库最大打开连接数
32
# SQL_MAX_OPEN_CONNS=1000
33
# 数据库连接最大生命周期（秒）
34
# SQL_MAX_LIFETIME=60
35

36

37
# 缓存相关配置
38
# Redis连接字符串
39
# REDIS_CONN_STRING=redis://user:password@localhost:6379/0
40
# 同步频率（单位：秒）
41
# SYNC_FREQUENCY=60
42
# 内存缓存启用
43
# MEMORY_CACHE_ENABLED=true
44
# 渠道更新频率（单位：秒）
45
# CHANNEL_UPDATE_FREQUENCY=30
46
# 批量更新启用
47
# BATCH_UPDATE_ENABLED=true
48
# 批量更新间隔（单位：秒）
49
# BATCH_UPDATE_INTERVAL=5
50

51
# 任务和功能配置
52
# 更新任务启用
53
# UPDATE_TASK=true
54

55
# 对话超时设置
56
# 所有请求超时时间，单位秒，默认为0，表示不限制
57
# RELAY_TIMEOUT=0
58
# 流模式无响应超时时间，单位秒，如果出现空补全可以尝试改为更大值
59
# STREAMING_TIMEOUT=300
60

61
# Gemini 识别图片 最大图片数量
62
# GEMINI_VISION_MAX_IMAGE_NUM=16
63

64
# 会话密钥
65
# SESSION_SECRET=random_string
66

67
# 其他配置
68
# 生成默认token
69
# GENERATE_DEFAULT_TOKEN=false
70
# Cohere 安全设置
71
# COHERE_SAFETY_SETTING=NONE
72
# 是否统计图片token
73
# GET_MEDIA_TOKEN=true
74
# 是否在非流（stream=false）情况下统计图片token
75
# GET_MEDIA_TOKEN_NOT_STREAM=false
76
# 设置 Dify 渠道是否输出工作流和节点信息到客户端
77
# DIFY_DEBUG=true
78

79
# LinuxDo相关配置
80
LINUX_DO_TOKEN_ENDPOINT=https://connect.linux.do/oauth2/token
81
LINUX_DO_USER_ENDPOINT=https://connect.linux.do/api/user
82

83
# 节点类型
84
# 如果是主节点则为master
85
# NODE_TYPE=master
86

87
EOF