个人网站主办者名称江西专业的企业网站建设公司

GitLab实现 HTTP 访问和 SMTP 邮件发送

本教程详细记录了如何配置 SMTP 邮件通知、实现外网 HTTP 访问，并分享在配置过程中遇到的问题及解决方法。

一、准备工作

1. 安装 Docker：确保在 Synology NAS 上安装 Docker 应用。
2. 下载 GitLab 镜像：在 Docker 应用中搜索并下载 gitlab/gitlab-ce 镜像。
3. 端口规划：规划好 HTTP 访问端口和 SMTP 邮件端口，以确保在内外网环境下正常访问。
4. 使用内网穿透工具（如花生壳）：若 NAS 没有公网 IP，使用内网穿透工具实现外网访问。

二、配置 GitLab 的 SMTP 邮件发送功能

由于 GitLab 默认不启用邮件发送功能，需配置 SMTP 以实现邮件通知。

1. SMTP 配置（以 163 邮箱为例）

在 gitlab.rb 文件中添加以下 SMTP 设置：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.163.com"
gitlab_rails['smtp_user_name'] = "your_email@163.com"
gitlab_rails['smtp_password'] = "your_password"
gitlab_rails['smtp_domain'] = "smtp.163.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_pool'] = false

2. 选择 SMTP 端口和加密配置

• SSL 端口（465）：

  gitlab_rails['smtp_port'] = 465
  gitlab_rails['smtp_enable_starttls_auto'] = false
  gitlab_rails['smtp_tls'] = true
  

• TLS 端口（587）：

  gitlab_rails['smtp_port'] = 587
  gitlab_rails['smtp_enable_starttls_auto'] = true
  gitlab_rails['smtp_tls'] = false
  

• 非加密端口（25）：

  gitlab_rails['smtp_port'] = 25
  gitlab_rails['smtp_enable_starttls_auto'] = false
  gitlab_rails['smtp_tls'] = false
  

3. 设置发件人邮箱

gitlab_rails['gitlab_email_from'] = 'your_email@163.com'

4. 重启 GitLab 并测试邮件发送

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

进入 GitLab 控制台，测试邮件发送：

gitlab-rails console
Notify.test_email('test@example.com', 'Test Subject', 'This is a test message').deliver_now

三、配置 GitLab 的外网 HTTP 访问

1. 配置 external_url 为 HTTP

在 gitlab.rb 文件中设置 HTTP 访问地址：

external_url 'http://yourdomain.peanuthull.com:8080'

2. 配置 Nginx 监听 HTTP 端口

确保 GitLab 内置的 Nginx HTTP 配置如下：

nginx['enable'] = true
nginx['listen_port'] = 80
nginx['redirect_http_to_https'] = false

3. 设置端口映射

• Docker 中将宿主机 8080 端口映射到 GitLab 容器的 80 端口。
• 花生壳中将外网 8080 端口映射到 GitLab 的 HTTP 端口（80）。

4. 重启 GitLab 服务

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

四、进入 GitLab Docker 容器

在调试或配置过程中，可进入容器以检查配置或查看日志。

1. 查看 GitLab 容器 ID

docker ps

2. 进入容器

docker exec -it <container_id> /bin/bash

五、配置 GitLab 的 HTTPS 访问

为了进一步保障访问安全，可以为 GitLab 配置 HTTPS 访问。以下是步骤：

1. 准备证书和密钥

需要获得 SSL 证书和密钥。可以使用已经购买的证书，或者使用免费的 SSL 自签证书。

2. 备份 GitLab 的配置文件

更改之前，备份 GitLab 配置文件。默认可以在 /etc/gitlab/gitlab.rb 中找到该文件。

3. 编辑 GitLab 的配置文件

1. 使用编辑器打开 /etc/gitlab/gitlab.rb 文件。
2. 修改 external_url 行，更改为您自己的域名：

   external_url 'http://gitlab.example.com'
   

4. 配置 Nginx 并设置 SSL

要在 GitLab 上启用 HTTPS，需要使用 Nginx 的 Web 服务器作为反向代理并设置 SSL 证书和密钥。

1. 在 GitLab Nginx 配置文件中（默认路径为 /etc/gitlab/gitlab.rb），添加以下行以启用 SSL：
   • 启用重定向：

     nginx['redirect_http_to_https'] = true
     

   • 配置证书路径：

     nginx['ssl_certificate'] = "/opt/gitlab/certs/checkqq.com.crt"
     nginx['ssl_certificate_key'] = "/opt/gitlab/certs/checkqq.com.key"
     

5. 重新配置 GitLab

运行以下命令以重新加载配置并应用更改：

sudo gitlab-ctl reconfigure

6. 重启 GitLab

重启 GitLab 服务：

sudo gitlab-ctl restart

六、常见问题与解决方法

1. 422 错误（The change you requested was rejected）
   确保 external_url 中的域名与实际访问的 URL 一致，清除浏览器缓存和 Cookie 后重试。

2. HTTP 和 HTTPS 混淆
   确保 external_url 和 Nginx 的协议一致。如果仅需 HTTP 访问，将 external_url 设置为 HTTP，并禁用 HTTPS 配置。

3. SMTP 端口配置错误
   确保 smtp_port、smtp_tls 和 smtp_enable_starttls_auto 设置与服务商要求一致。

七、总结

通过以上步骤，你可以成功在 Synology NAS 上通过 Docker 安装 GitLab，配置 SMTP 邮件发送功能及 HTTP 外网访问。