跳转至

安装☍

公共环境☍

公共环境可直接在线使用。

环境地址☍

环境 地址
生产环境 https://api.zashigaofa.com
测试环境 https://api.zashigaofa.cn

使用说明☍

  1. 直接访问上述地址即可使用系统
  2. 无需安装部署，无需配置环境
  3. 支持在线体验所有功能
  4. 数据定期清理，请勿存储重要数据

私有部署☍

镜像名称 版本 大小
zsgf.ui Docker Image Version Docker Image Size
zsgf Docker Image Version Docker Image Size

一体化部署☍

使用 Docker Compose 进行快速部署，适合单机环境。

服务器配置建议

  • Docker 20.10+
  • Docker Compose 2.0+
  • 至少 4GB 可用内存
  • 至少 20GB 可用磁盘空间
  • 支持 HTTPS 的域名（可选）
1
2
mkdir zsgf-deploy
cd zsgf-deploy

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
version: '3.8'

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: zsgf
    volumes:
      - mysql_data:/var/lib/mysql
    ports:
      - "3306:3306"

  mongodb:
    image: mongo:6.0
    volumes:
      - mongodb_data:/data/db
    ports:
      - "27017:27017"

  rabbitmq:
    image: rabbitmq:3-management
    environment:
      RABBITMQ_DEFAULT_USER: admin
      RABBITMQ_DEFAULT_PASS: your_rabbitmq_password
    ports:
      - "5672:5672"
      - "15672:15672"

  seq:
    image: datalust/seq:latest
    environment:
      ACCEPT_EULA: Y
      SEQ_API_KEY: foyyznOCTjwP6EaiF6nc
    ports:
      - "5341:80"
    volumes:
      - seq_data:/data

  api:
    image: wzhen123456/zsgf:latest
    depends_on:
      - mysql
      - mongodb
      - seq
      - rabbitmq
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - RABBITMQ=amqp://admin:your_rabbitmq_password@rabbitmq:5672
      - MYSQL=Server=mysql;Database=zsgf;User=root;Password=your_root_password;
      - MONGODB=mongodb://mongodb:27017
      - SWAGGER=true
      - SEQ=http://seq:5341
      - SEQ_APIKEY=foyyznOCTjwP6EaiF6nc
    ports:
      - "5000:80"

  ui:
    image: wzhen123456/zsgf.ui:latest
    ports:
      - "80:80"
    depends_on:
      - api

volumes:
  mysql_data:
  mongodb_data:
  seq_data:

1
docker-compose up -d

API 服务支持以下环境变量配置：

配置项 类型 描述
ASPNETCORE_ENVIRONMENT 必须 Development 或 Production
RABBITMQ 必须 RabbitMQ 消息队列连接地址
MYSQL 必须 MySQL 数据库连接字符串
MONGODB 必须 MongoDB 数据库连接字符串
SWAGGER 可选 是否启用 Swagger 文档界面
SEQ 可选 Serilog 日志 Seq 服务器地址
SEQ_APIKEY 可选 Serilog 日志 Seq 认证密钥

分布式部署☍

服务器配置建议

  • 建议配置：4核8G
  • 磁盘：SSD，至少100GB
  • 网络：内网带宽100Mbps以上
1
2
3
4
5
6
7
docker run -d \
  --name mysql \
  -e MYSQL_ROOT_PASSWORD=your_root_password \
  -e MYSQL_DATABASE=zsgf \
  -v mysql_data:/var/lib/mysql \
  -p 3306:3306 \
  mysql:8.0

服务器配置建议

  • 建议配置：4核8G
  • 磁盘：SSD，至少100GB
  • 网络：内网带宽100Mbps以上
1
2
3
4
5
docker run -d \
  --name mongodb \
  -v mongodb_data:/data/db \
  -p 27017:27017 \
  mongo:6.0

服务器配置建议

  • 建议配置：2核4G
  • 磁盘：SSD，至少200GB
  • 网络：内网带宽50Mbps以上
1
2
3
4
5
6
docker run -d \
  --name seq \
  -e ACCEPT_EULA=Y \
  -v seq_data:/data \
  -p 5341:80 \
  datalust/seq:latest

服务器配置建议

  • 建议配置：2核4G
  • 磁盘：SSD，至少50GB
  • 网络：内网带宽50Mbps以上
1
2
3
4
docker run -d \
  --name ui \
  -p 80:80 \
  wzhen123456/zsgf.ui:latest

服务器配置建议

  • 建议配置：4核8G
  • 磁盘：SSD，至少50GB
  • 网络：内网带宽100Mbps以上
1
2
3
4
5
6
7
docker run -d \
  --name api \
  -e ConnectionStrings__DefaultConnection="Server=mysql_server_ip;Database=zsgf;User=root;Password=your_root_password;" \
  -e MongoDB__ConnectionString="mongodb://mongodb_server_ip:27017" \
  -e Seq__ServerUrl="http://seq_server_ip:5341" \
  -p 5000:80 \
  wzhen123456/zsgf:latest

云存储挂载☍

支持将云存储挂载到容器的 /app/files 路径，用于存储应用文件。

支持的云存储服务☍

  • 阿里云 OSS
  • 腾讯云 COS
  • 华为云 OBS

挂载说明☍

应用的文件存储路径为容器内的 /app/files 目录，您可以通过以下方式将云存储挂载到该路径：

  1. 使用云存储的挂载工具将存储桶挂载到本地目录
  2. 在运行 API 容器时，将挂载的本地目录映射到容器的 /app/files 路径

例如，在运行 API 容器时添加以下挂载配置：

1
2
3
4
5
docker run -d \
  --name api \
  -v /path/to/mounted/storage:/app/files \
  ...其他配置...
  wzhen123456/zsgf:latest

配置步骤☍

1
2
3
4
5
6
7
# 安装 ossutil
wget http://gosspublic.alicdn.com/ossutil/1.7.7/ossutil64
chmod 755 ossutil64
./ossutil64 config

# 挂载 OSS 到本地目录
./ossutil64 mount oss://your-bucket-name /path/to/mounted/storage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 安装 cosfs
wget https://github.com/tencentyun/cosfs/releases/download/v1.0.19/cosfs_1.0.19_centos7.0_x86_64.rpm
rpm -ivh cosfs_1.0.19_centos7.0_x86_64.rpm

# 配置密钥
echo your-bucket-name:your-secret-id:your-secret-key > /etc/passwd-cosfs
chmod 640 /etc/passwd-cosfs

# 挂载 COS 到本地目录
cosfs your-bucket-name /path/to/mounted/storage -ourl=http://cos.myqcloud.com

1
2
3
4
5
6
7
8
# 安装 obsfs
wget https://obs-community.obs.cn-north-1.myhuaweicloud.com/obsfs/current/obsfs_centos7.6_amd64.tar.gz
tar -xzvf obsfs_centos7.6_amd64.tar.gz
cd obsfs_centos7.6_amd64
./install.sh

# 挂载 OBS 到本地目录
obsfs your-bucket-name /path/to/mounted/storage -ourl=http://obs.cn-north-1.myhuaweicloud.com

注意事项☍

  1. 确保云存储服务已开通并创建存储桶
  2. 配置适当的访问权限和防盗链设置
  3. 定期备份重要数据
  4. 监控存储使用量和费用
  5. 确保挂载目录具有适当的读写权限
  6. 建议使用系统服务确保挂载点开机自启

评论