news 2026/1/20 10:07:29

Docker一站式部署:RustFS、GoFastDFS、Gitea与PostgreSQL实战指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Docker一站式部署:RustFS、GoFastDFS、Gitea与PostgreSQL实战指南

1. 前言

在现代软件开发和部署中,Docker已成为不可或缺的工具。它提供了轻量级、可移植的容器化解决方案,使应用部署变得简单高效。本文将详细介绍如何使用Docker一键部署四个常用服务:RustFS(高性能文件存储)、GoFastDFS(分布式文件系统)、Gitea(自托管Git服务)和PostgreSQL(关系型数据库)。无论你是个人开发者还是团队负责人,这些服务都能为你的项目提供强大支持。

2. 前提条件

  • 已安装Docker(版本20.10+)
  • 已安装Docker Compose(版本1.29+)
  • 64位操作系统(Windows/Linux/Mac)
  • 至少4GB可用内存

3. RustFS部署

RustFS是一款使用Rust语言编写的高性能文件存储系统,支持S3协议,适用于私有云存储场景。

3.1 Docker命令部署

Linux: docker run -d \ --name rustfs_container \ --user root \ -p 9000:9000 \ -p 9001:9001 \ -v D:/ProgramData/docker/rustfs/data:/data:z \ -e RUSTFS_ACCESS_KEY=rustfsadmin \ -e RUSTFS_SECRET_KEY=rustfsadmin \ -e RUSTFS_CONSOLE_ENABLE=true \ rustfs/rustfs:latest \ --address 0.0.0.0:9000 \ --console-enable \ --console-address 0.0.0.0:9001 \ --access-key rustfsadmin \ --secret-key rustfsadmin Windows: docker run -d ` --name rustfs_container ` --user root ` -p 9000:9000 ` -p 9001:9001 ` -v D:/ProgramData/docker/rustfs/data:/data:z ` -e RUSTFS_ACCESS_KEY=rustfsadmin ` -e RUSTFS_SECRET_KEY=rustfsadmin ` -e RUSTFS_CONSOLE_ENABLE=true ` rustfs/rustfs:latest ` --address 0.0.0.0:9000 ` --console-enable ` --console-address 0.0.0.0:9001 ` --access-key rustfsadmin ` --secret-key rustfsadmin 界面:http://localhost:9001/rustfs/console/browser

参数说明:

  • --user root: 以root用户运行容器
  • -p 9000:9000: 映射API端口
  • -p 9001:9001: 映射控制台端口
  • -v: 挂载数据卷
  • RUSTFS_ACCESS_KEYRUSTFS_SECRET_KEY: 访问凭证
  • --console-enable: 启用Web控制台

3.2 Docker Compose部署(推荐)

创建docker-compose.yml文件:

version: '3.8' services: rustfs: image: rustfs/rustfs:latest container_name: rustfs_container user: root ports: - "9000:9000" - "9001:9001" volumes: - D:/ProgramData/docker/rustfs/data:/data:z environment: - RUSTFS_ACCESS_KEY=rustfsadmin - RUSTFS_SECRET_KEY=rustfsadmin - RUSTFS_CONSOLE_ENABLE=true command: > --address 0.0.0.0:9000 --console-enable --console-address 0.0.0.0:9001 --access-key rustfsadmin --secret-key rustfsadmin restart: unless-stopped

启动服务:

docker-compose up -d

访问控制台:http://localhost:9001/rustfs/console/browser
默认登录凭证:用户名/密码均为rustfsadmin

4. GoFastDFS部署

GoFastDFS是一个基于Golang实现的高性能分布式文件系统,适合大文件存储。

4.1 下载配置文件

GoFastDFS东西有点多,无法把内容全部写上,请从网盘下载Docker的安装

部分docker-compose.yml

#version: '3.4' services: fastdfs1: # build: # context: . # dockerfile: Dockerfile image: sjqzhang/go-fastdfs:latest #docker pull sjqzhang/go-fastdfs container_name: fastdfs1 privileged: true restart: always #networks: # - extnetwork volumes: - type: bind source: ./fastdfs/data1 target: /usr/local/go-fastdfs/data ports: - "9527:8080" fastdfs2: # build: # context: . # dockerfile: Dockerfile image: sjqzhang/go-fastdfs:latest #docker pull sjqzhang/go-fastdfs container_name: fastdfs2 privileged: true restart: always #networks: # - extnetwork volumes: - type: bind source: ./fastdfs/data2 target: /usr/local/go-fastdfs/data ports: - "9526:8080" nginx: image: nginx:latest container_name: fileserver-nginx privileged: true restart: always #networks: # - extnetwork ports: - "9528:80" volumes: - type: bind source: ./nginx/nginx.conf target: /etc/nginx/nginx.conf - type: bind source: ./nginx/static target: /usr/share/nginx/html - type: bind source: ./nginx/log target: /var/log/nginx fastdfs-web: build: context: ./fastdfs-web dockerfile: Dockerfile image: fastdfs-web:latest #docker pull sjqzhang/go-fastdfs container_name: fastdfs-web volumes: - type: bind source: ./fastdfs-web/db/go-fastdfs.db target: /db/go-fastdfs.db - type: bind source: ./fastdfs-web/logs target: /logs privileged: true restart: always #networks: # extnetwork: # ipv4_address: 172.19.0.20 ports: - "8099:8088" links: - fastdfs1 - fastdfs2 depends_on: - fastdfs1 - fastdfs2 networks: extnetwork: driver: bridge ipam: config: - subnet: 172.19.0.0/16

4.2 启动服务

docker-compose up -d

访问Web界面:http://localhost:8099
初次访问会要求设置管理员密码,请妥善保存。

5. Gitea部署

Gitea是一个轻量级的自托管Git服务,适合团队代码管理和协作。

5.1 创建Docker Compose文件

创建gitea-compose.yml文件:

version: "3" services: gitea: image: gitea/gitea:latest container_name: gitea restart: always environment: - USER_UID=1000 - USER_GID=1000 - TZ=Asia/Shanghai ports: - "3000:3000" # HTTP - "222:22" # SSH(避免与主机22端口冲突) volumes: - D:/ProgramData/docker/gitea/gitea:/data - D:/ProgramData/docker/gitea/etc/timezone:/etc/timezone:ro - D:/ProgramData/docker/gitea/etc/localtime:/etc/localtime:ro

6. PostgreSQL部署

PostgreSQL是一个强大的开源对象关系数据库系统。

6.1 创建Docker Compose文件

创建postgres-compose.yml文件:

version: '3.8' services: postgres: image: postgres:latest container_name: postgres_container environment: - POSTGRES_USER=postgres - POSTGRES_PASSWORD=postgres_password - POSTGRES_DB=postgres volumes: - D:/ProgramData/docker/postgres/data:/var/lib/postgresql/data ports: - "5432:5432" restart: unless-stopped

Dockerfie:

# 使用明确的 PostgreSQL 版本(推荐) FROM postgres:17 # 设置环境变量 ENV POSTGRES_USER=postgres ENV POSTGRES_PASSWORD=postgres ENV POSTGRES_DB=postgres # 安装编译依赖 + PostgreSQL 开发包 RUN apt-get update && \ apt-get install -y \ build-essential \ git \ cmake \ libssl-dev \ libpq-dev \ zlib1g-dev \ postgresql-server-dev-17 && \ rm -rf /var/lib/apt/lists/* # 克隆并编译 pgvector RUN git clone --branch v0.8.1 https://github.com/pgvector/pgvector.git /pgvector && \ cd /pgvector && \ make && \ make install # 可选:清理源码(减小镜像体积) RUN rm -rf /pgvector # 复制初始化脚本(如果需要自动启用 extension) COPY init.sql /docker-entrypoint-initdb.d/

init.sql

-- 启用 vector 扩展 CREATE EXTENSION IF NOT EXISTS vector; -- 创建一个示例表 CREATE TABLE example ( id SERIAL PRIMARY KEY, name VARCHAR(100) NOT NULL, embedding VECTOR(3) -- 假设嵌入维度为3 ); -- 插入一些示例数据 INSERT INTO example (name, embedding) VALUES ('Alice', '[1.0, 2.0, 3.0]'), ('Bob', '[4.0, 5.0, 6.0]');

7. 一体化部署方案

将所有服务整合到一个docker-compose.yml文件中:

version: '3.8' services: rustfs: image: rustfs/rustfs:latest container_name: rustfs_container user: root ports: - "9000:9000" - "9001:9001" volumes: - D:/ProgramData/docker/rustfs/data:/data:z environment: - RUSTFS_ACCESS_KEY=rustfsadmin - RUSTFS_SECRET_KEY=rustfsadmin - RUSTFS_CONSOLE_ENABLE=true command: > --address 0.0.0.0:9000 --console-enable --console-address 0.0.0.0:9001 --access-key rustfsadmin --secret-key rustfsadmin restart: unless-stopped gofastdfs: image: sjq0/rush:latest container_name: gofastdfs_container ports: - "8080:8080" volumes: - D:/ProgramData/docker/gofastdfs/data:/data:z environment: - GO_FASTDFS_DIR=/data restart: unless-stopped postgres: image: postgres:latest container_name: postgres_container environment: - POSTGRES_USER=postgres - POSTGRES_PASSWORD=postgres_password - POSTGRES_DB=postgres - PGDATA=/var/lib/postgresql/data/pgdata volumes: - D:/ProgramData/docker/postgres/data:/var/lib/postgresql/data ports: - "5432:5432" restart: unless-stopped gitea: image: gitea/gitea:latest container_name: gitea_container environment: - USER_UID=1000 - USER_GID=1000 - ROOT_URL=http://localhost:3000/ - DB_TYPE=postgres - DB_HOST=postgres:5432 - DB_NAME=gitea - DB_USER=postgres - DB_PASSWD=postgres_password restart: always volumes: - D:/ProgramData/docker/gitea/data:/data - /etc/localtime:/etc/localtime:ro ports: - "3000:3000" - "222:22" depends_on: - postgres

7.1 启动所有服务

docker-compose up -d

7.2 服务访问地址

  • RustFS控制台:http://localhost:9001/rustfs/console/browser
  • GoFastDFS管理界面:http://localhost:8080
  • Gitea:http://localhost:3000
  • PostgreSQL:localhost:5432 (使用pgAdmin或命令行客户端连接)

8. 常见问题与解决方案

8.1 Windows路径问题

在Windows系统中,Docker可能无法访问非共享目录。确保:

  1. Docker Desktop中已设置目录共享
  2. 使用绝对路径,如:D:\\ProgramData\\docker\\rustfs\\data
  3. 避免使用空格和特殊字符

8.2 端口冲突

如果遇到端口冲突,修改docker-compose.yml中的主机端口映射,例如将"3000:3000"改为"3001:3000"

8.3 权限问题

在Linux系统上,可能需要设置正确的文件权限:

chmod -R 777 D:/ProgramData/docker/

9. 后续优化建议

  1. 配置HTTPS:为所有服务配置SSL证书
  2. 设置备份策略:定期备份数据卷
  3. 资源限制:在docker-compose.yml中设置内存和CPU限制
  4. 监控系统:添加Prometheus+Grafana监控
  5. 日志管理:配置集中式日志收集系统

10. 总结

通过Docker,我们可以轻松部署和管理多个服务,无需担心环境依赖和配置冲突。本文详细介绍了RustFS、GoFastDFS、Gitea和PostgreSQL的Docker部署方案,提供了完整的docker-compose配置,使开发和运维工作更加高效。这些服务的组合为开发团队提供了完整的基础设施:代码托管(Gitea)、文件存储(RustFS/GoFastDFS)和数据存储(PostgreSQL)。

记住定期更新容器镜像,保持系统安全。在生产环境中,还需要考虑高可用性和灾备方案。

提示:本文中的所有配置均可根据实际需求进行调整,特别是数据存储路径和访问凭证,建议在生产环境中使用强密码并妥善保管。


本文首发于CSDN,转载请注明出处。
作者:DevOps实践者
时间:2026年01月18日

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/1/20 3:25:20

从Demo到上线:CosyVoice-300M Lite生产环境迁移教程

从Demo到上线:CosyVoice-300M Lite生产环境迁移教程 1. 引言 1.1 业务场景描述 随着语音交互在智能客服、有声内容生成、无障碍服务等领域的广泛应用,企业对轻量、高效、低成本的文本转语音(TTS)服务需求日益增长。然而&#x…

作者头像 李华
网站建设 2026/1/20 6:25:48

Qwen3-VL-2B免配置部署:开箱即用视觉AI实战推荐

Qwen3-VL-2B免配置部署:开箱即用视觉AI实战推荐 1. 引言 随着多模态大模型的快速发展,视觉语言模型(Vision-Language Model, VLM)正逐步从研究实验室走向实际应用场景。其中,Qwen系列推出的 Qwen/Qwen3-VL-2B-Instru…

作者头像 李华
网站建设 2026/1/20 2:45:19

TurboDiffusion安装报错?SageAttention依赖环境配置避坑指南

TurboDiffusion安装报错?SageAttention依赖环境配置避坑指南 1. 引言:TurboDiffusion与SageAttention的工程挑战 1.1 技术背景 TurboDiffusion是由清华大学、生数科技与加州大学伯克利分校联合推出的视频生成加速框架,基于Wan2.1/Wan2.2模…

作者头像 李华
网站建设 2026/1/19 1:22:53

VibeVoice-TTS-Web-UI技术解析:下一代TTS框架创新点揭秘

VibeVoice-TTS-Web-UI技术解析:下一代TTS框架创新点揭秘 1. 引言:从播客生成到多说话人对话合成的技术跃迁 随着内容创作形式的多样化,传统文本转语音(TTS)系统在面对长篇、多角色对话场景时逐渐暴露出局限性。无论是…

作者头像 李华
网站建设 2026/1/19 1:22:45

AI视频生成新标杆:深度评测Image-to-Video实际表现

AI视频生成新标杆:深度评测Image-to-Video实际表现 1. 引言 近年来,AI驱动的视频生成技术取得了突破性进展,尤其是图像转视频(Image-to-Video, I2V)领域,正逐步从实验室走向实际应用。在众多开源项目中&a…

作者头像 李华
网站建设 2026/1/19 1:22:07

opencode令牌分析插件使用:资源监控实战教程

opencode令牌分析插件使用:资源监控实战教程 1. 引言 随着AI编程助手在开发流程中的深度集成,开发者对工具的智能化、安全性与可扩展性提出了更高要求。OpenCode作为2024年开源的终端优先AI编码框架,凭借其多模型支持、隐私安全设计和插件化…

作者头像 李华