威联通Container Station实战：用Docker三件套搭建企业级GitLab（附邮件服务器配置）

威联通NAS上构建企业级GitLab：从容器编排到邮件服务的完整实战

对于许多中小型技术团队和独立开发者而言，在公有云上托管代码仓库虽然方便，但数据安全、成本控制和定制化需求常常成为痛点。拥有一台威联通NAS，意味着你手边就有一台性能可靠、存储充裕的私有服务器。而将GitLab这样的企业级DevOps平台部署其上，不仅能实现代码的完全自主掌控，还能无缝集成CI/CD流水线，打造一个真正属于团队的高效协作环境。今天，我们就来深入探讨如何利用威联通NAS的Container Station，通过Docker Compose编排PostgreSQL、Redis和GitLab容器，构建一个稳定、可扩展且功能完备的私有GitLab实例，并重点解决让许多新手头疼的邮件服务器配置问题。

1. 环境准备与架构设计

在开始动手之前，我们需要对整体架构有一个清晰的认识。一个生产可用的GitLab实例并非单个容器那么简单，它依赖于数据库和缓存服务。我们将采用经典的“三件套”架构：GitLab作为主应用，PostgreSQL作为关系型数据库存储项目元数据和用户信息，Redis作为缓存和后台任务队列。这种分离部署的方式不仅符合最佳实践，也便于日后独立升级或扩展某个组件。

硬件与系统要求：威联通NAS的型号众多，从入门级的TS-231P到企业级的TS-1685都可以运行Docker。但GitLab相对资源密集，我建议为它分配至少4GB的可用内存。如果你的NAS物理内存只有4GB，可能需要考虑升级，或者确保在运行GitLab时关闭其他内存消耗大的服务。存储方面，由于我们要挂载数据卷，请确保你的存储池有足够的空间，我通常会预留至少50GB给GitLab及其数据。

软件准备：

1. Container Station：从威联通的App Center中安装。这是威联通的Docker管理界面，底层基于标准的Docker引擎。
2. SSH访问：虽然Container Station提供了图形界面，但很多高级配置和问题排查通过命令行更高效。在威联通的控制面板中启用SSH服务。
3. 共享文件夹规划：这是数据持久化的关键。我习惯在/share/Container下为每个重要服务创建独立的文件夹。例如，我们将创建：

   /share/Container/gitlab/
   ├── config/   # 用于挂载GitLab配置文件
   ├── data/     # 用于挂载GitLab主数据（仓库、上传文件等）
   ├── logs/     # 用于挂载GitLab日志
   ├── postgresql/ # PostgreSQL数据卷
   └── redis/      # Redis数据卷
   

   你可以通过File Station图形化创建这些文件夹，并注意设置正确的权限。一个常见的坑是文件夹权限问题，如果容器内进程的用户ID（UID）和组ID（GID）与宿主机文件夹的权限不匹配，会导致容器启动失败。一个稳妥的方法是，通过SSH登录NAS，将上述文件夹的权限设置为777（仅用于测试和简化流程），在生产环境中则应仔细匹配UID/GID。

注意：直接使用chmod 777会降低安全性，仅建议在初次搭建验证时使用。长期运行，应创建专用的系统用户并赋予相应目录的 ownership。例如，GitLab官方镜像内部常以git用户（UID 998）运行，你可以通过chown -R 998:998 /share/Container/gitlab/data来调整。

2. 编写Docker Compose编排文件

Docker Compose是管理多容器应用的利器。威联通的Container Station原生支持通过YAML文件创建应用堆栈，这比在图形界面逐个点击配置要清晰和可重复得多。我们将编写一个docker-compose.yml文件来定义我们的三个服务。

下面是一个经过优化的配置示例，它包含了数据持久化、网络配置以及一些关键的环境变量：

version: '3.8'

services:
  postgresql:
    image: postgres:13-alpine
    container_name: gitlab-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: gitlab
      POSTGRES_PASSWORD: your_strong_postgres_password_here
      POSTGRES_DB: gitlabhq_production
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
    volumes:
      - /share/Container/gitlab/postgresql:/var/lib/postgresql/data
    networks:
      - gitlab-network
    healthcheck:
      test: ["CMD-SHELL", "