【宋词】《定风波》 苏轼：莫听穿林打叶声。何妨吟啸且徐行。竹杖芒鞋轻胜马。谁怕。一蓑烟雨任平生。料峭春风吹酒醒。微冷。山头斜照却相迎。

永夜

没有不值得去解决的问题，也没有不值得去学习的技术！

Ubuntu 26.04 + Docker 搭建 Go Gin 开发环境（全记录）

📸 浏览器显示 JSON 数据，如图4

作者：

永夜

在

, , , , , , , , , , , , , , , , , , ,

从 Windows 到 Ubuntu：迁移与配置完全指南

在启动项列表中找到刚创建的 Ubuntu Installer，通过右侧的 “上移” 按钮将其移到第一位。这样重启后电脑会优先从这个启动项引导。

(1) 从 Windows 10 迁移至 Ubuntu – 上篇：安装前的准备工作

如图24 – 选择 Ubuntu 外观，高亮默认

(2) 从 Windows 10 迁移至 Ubuntu – 下篇：Ubuntu 26.04 安装与首次配置

安装完成后，打开 Fcitx5 配置工具（fcitx5-configtool），在“输入法”选项卡中添加 “五笔拼音” 即可正常使用。

(3) Ubuntu 初始化配置（基本设置、软件安装）

图10 – 新分区信息（UUID、卷标、文件系统）

(4) Ubuntu 磁盘规划：将 /home 迁移到第二块 SSD

如图10：点击 安装 按钮，进度条显示“正在准备…”。

(5) Ubuntu 26.04 软件安装与维护最佳实践：以微信为例

图中查找范围为 /home/wangqiang，名称列表里仅有「下载」和「xwechat_files」两个文件夹

(6) 解决 Linux 微信「另存为」对话框只显示两个文件夹的问题

图1 重启后右上角没有输入法图标

(7) Ubuntu 26.04 输入法折腾记：从 Fcitx5 自启失败到五笔拼音稳定使用

下图为实拍照片（图3）： (此处为双屏实物照片，展示左外接、右笔记本的布局，两台显示器并排亮起)

(8) Ubuntu 双屏幕配置实战：ThinkPad T570 外接显示器，左屏右本更顺手

中文部分显示为梦源宋体，清晰舒适

(9) 从思源到梦源：在 Ubuntu 26.04 上把宋体“折腾”明白

至此，三个数据库容器均已正常运行。

(10) 配置开发环境：使用 Docker 管理多版本 MySQL 与 Redis

SOLO 模式欢迎界面，我切换到了 IDE

(11) 从百度API推送到AI IDE选型：我如何搞定Trae安装并准备开工

如图15：授权完成后，Gmail 账号成功添加。最终，Thunderbird 账户列表里一共添加了 8 个邮箱。

(12) Ubuntu 26.04 邮件客户端折腾记：从网易邮箱大师到 Thunderbird，一口气添加 8 个邮箱

图1：优化前60标签整机内存占用截图（原始满载19GB+）

(13) Ubuntu 26.04 下 Chrome 高内存占用优化全记录｜同60标签，Win10≈7GB，Ubuntu暴涨至20GB排坑实录

📸 浏览器显示 JSON 数据，如图4

(14) Ubuntu 26.04 + Docker 搭建 Go Gin 开发环境（全记录）

在保存对话框中找到 显示选项 - 编码 ，将其从“自动检测”改为 UTF-8。

(15) Ubuntu 打开 Windows 文档提示“无效字符”？我的解决方法

从截图中可以看到，我连续执行了 mv、chmod、nano，最后 ssh aliyun 一气呵成，直接显示欢迎信息和上次登录时间，没有任何密码询问。

(16) 告别密码与断连：阿里云 ECS SSH 免密登录与心跳保活实践

[截图 5：扩展显示“用户已全局禁用此扩展”及右键菜单]

(17) 在 Trae CN 中尝试 Dev Containers：一次不太成功的踩坑记录

Docker 扩展面板的容器操作菜单

(18) 从零到一：在 Trae CN + Docker 中搭建 Go + Gin 开发环境

Flameshot 的功能

(19) 告别微信窗口限制：在 Ubuntu 26.04 使用 Flameshot 绑定全局 Alt+A 截图

微信的内存占用高达 2.01 GB（1.5%）；而在只开启一个标签页的情况下，Google Chrome 的内存占用更是达到了 2.96 GB（1.0%）。

(20) Ubuntu 26.04 软件安装与维护最佳实践更新：从 Chrome 内存暴涨排坑到弃用 Flatpak 重度应用

deb 版 Firefox 更实用：能直接访问 Chrome 配置文件，资源占用更小。现在开启 4 个窗口，50 个标签页，内存占用 5 GB 左右

(21) Ubuntu 26.04 下从 Chrome 迁移到 Firefox：我的折腾经历

如图4：将中州韵加入输入法列表

(22) 从 Windows 到 Ubuntu：Rime → wbpy 的输入法选型失败记录

about:config

(23) Ubuntu 26.04 桌面性能优化实战：从卡顿到稳定运行的完整调优记录

图6：创建独立的 systemd 配置文件，将三种合盖情况全部设置为 ignore

(24) Ubuntu ThinkPad T570 挂起后黑屏：最终关闭自动挂起与合盖挂起，避免频繁强制关机

图 1：通过本地 .deb 安装包升级 VS Code 1.132.0，并发现系统中存在可清理的 Rime 相关软件包

(25) Ubuntu 26.04 升级 VS Code 1.132.0，并清理 Rime 残留：Fcitx5 五笔拼音验证正常

【图 4：Flameshot 14 双屏选择界面】

(26) Ubuntu 26.04 双屏 Flameshot 只能截副屏？升级 14.0 解决 Wayland 截图问题

Post Views: 97

从 Windows WSL2 无缝迁移到 Ubuntu 裸机，基于现有 MySQL/Redis 容器构建 Go 开发环境，并接入自定义网络。

📌 前言

之前一直在 Windows 10 + WSL2 中学习 go-gin-learning 项目，现在换到了全新的 Ubuntu 26.04 系统。希望继续使用 Docker 来隔离开发环境，同时复用已经部署好的 MySQL 8.0 和 Redis 7.2 容器（位于自定义网络 services_dev-network 中）。

本文记录了从零开始配置的全部步骤，包含：

  • 系统工具检查与安装
  • Docker 环境验证
  • 项目代码克隆
  • 编写 Dockerfile 预装 git
  • 编写 docker-compose.yml 接入现有网络
  • 容器内运行 Gin 应用并测试连通性
  • 常见问题与避坑建议

🧰 一、准备工作：检查系统已有工具

在 Ubuntu 中养成“先检查，后安装”的习惯，可以避免重复操作。

1.1 检查 Git

Bash
git --version

输出示例（已安装）：

Plaintext
git version 2.53.0

若未安装，执行：

Bash
sudo apt install git -y

1.2 检查 Docker

Bash
docker --version
docker compose version

输出示例：

Plaintext
Docker version 29.5.2, build 79eb04c
Docker Compose version v5.1.4

若未安装，请参考 Docker 官方文档 安装。

✅ 建议：将当前用户加入 docker 组，避免每次输入 sudo：

Bash
sudo usermod -aG docker $USER

然后注销并重新登录。

🌐 二、确认已有数据库网络环境

之前已经在 ~/docker/services 中通过 docker-compose.yml 运行了 MySQL 8.0 和 Redis 7.2，并创建了自定义网络 services_dev-network。

2.1 查看网络

Bash
docker network ls | grep dev-network

输出：

Plaintext
71f462c6ef91   services_dev-network   bridge    local

2.2 查看数据库容器状态

Bash
docker ps --filter "name=mysql80" --filter "name=redis72"

输出：

Plaintext
CONTAINER ID   IMAGE       ...   NAMES
9ec38ca384b6   redis:7.2   ...   redis72
4e93fd2e2c3f   mysql:8.0   ...   mysql80

💡 关键信息：

  • MySQL 容器名：mysql80，内部端口 3306，宿主机映射端口 3307
  • Redis 容器名：redis72，内部端口 6379
  • 网络名：services_dev-network（注意前缀，由 ~/docker/services 目录名派生）

📁 三、创建代码目录并克隆项目

选择一个语义清晰的目录存放项目代码，这里使用 ~/code（全小写，符合 Linux 惯例）。

Bash
mkdir -p ~/code
cd ~/code
git clone https://github.com/shuijingwan/go-gin-learning.git
cd go-gin-learning

检查项目结构：

Bash
ls -la

🐳 四、编写 Dockerfile（预装 git）

为了不在每次进入容器时手动安装 git，我们创建一个自定义镜像。

创建 Dockerfile：

Bash
FROM golang:1.26-alpine

# 安装 git（go mod 下载某些依赖时需要）
RUN apk add --no-cache git

# 设置工作目录，与后面的 docker-compose 保持一致
WORKDIR /code

# 保持容器运行（开发模式）
CMD ["tail", "-f", "/dev/null"]

📌 说明：

  • 使用 Alpine 版本镜像，体积小
  • apk add --no-cache 不保留缓存，减小镜像大小
  • WORKDIR /code 后续可以省略 docker-compose 中的 working_dir，但为了明确，两边都保留也没问题

⚙️ 五、编写 docker-compose.yml（接入现有网络）

关键点：

  • 使用 build: . 而不是 image: ...
  • 加入外部网络 services_dev-network
  • 传递数据库连接所需的环境变量
  • 删除已过时的 version 字段

最终 docker-compose.yml 内容：

YAML
services:
  go:
    build: .
    container_name: go-gin-learning
    working_dir: /code
    volumes:
      - ./:/code
    ports:
      - "8080:8080"
    tty: true
    stdin_open: true
    environment:
      - GOPROXY=https://goproxy.io,direct
      - GOSUMDB=sum.golang.google.cn
      - CGO_ENABLED=0
      # 数据库连接配置（使用现有网络中的服务名）
      - DB_HOST=mysql80
      - DB_PORT=3306
      - DB_USER=root
      - DB_PASSWORD=mystrongpwd80
      - DB_NAME=go_gin
      - REDIS_HOST=redis72
      - REDIS_PORT=6379
      - REDIS_PASSWORD=myredispass
    networks:
      - services_dev-network

networks:
  services_dev-network:
    external: true

⚠️ 注意：

  • DB_PASSWORD 和 REDIS_PASSWORD 要与 ~/docker/services/docker-compose.yml 中的密码完全一致。
  • 容器间通信使用内部端口 3306 和 6379，而不是宿主机映射的 3307。

🚀 六、构建并启动开发容器

Bash
# 停止并删除旧容器（如果有）
docker compose down

# 构建镜像（--no-cache 确保重新安装 git）
docker compose build --no-cache

# 启动容器（后台运行）
docker compose up -d

查看运行状态：

Bash
docker ps --filter "name=go-gin-learning"

🧪 七、进入容器并验证连接

7.1 进入容器

Bash
docker exec -it go-gin-learning sh

此时提示符变为 /code #。

7.2 验证 git 已安装

Bash
git --version

应输出类似 git version 2.52.0。

7.3 测试网络连通性

Bash
# 安装测试工具（仅调试用，正式镜像可不加）
apk add iputils mysql-client redis

# ping 数据库容器
ping -c 2 mysql80
ping -c 2 redis72

7.4 测试 MySQL 连接（禁用 SSL）

MySQL 8.0 默认要求 SSL，但在容器内部使用 --ssl=0 即可绕过证书验证：

Bash
mariadb -h mysql80 -P 3306 -u root -pmystrongpwd80 -e "SHOW DATABASES;" --ssl=0

预期输出：如图1

Plaintext
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+

💡 若使用 mysql 命令，请用 --ssl-mode=DISABLED。

7.5 测试 Redis 连接

Bash
redis-cli -h redis72 -a myredispass PING

预期输出：如图2

预期输出：如图2
Plaintext
PONG

🏃 八、运行 Gin 应用

在容器内执行：

Bash
go run main.go

看到如下日志表示成功：如图3

看到如下日志表示成功：如图3
Plaintext
go: downloading github.com/go-playground/locales v0.14.1
[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.

[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:	export GIN_MODE=release
 - using code:	gin.SetMode(gin.ReleaseMode)

[GIN-debug] GET    /albums                   --> main.getAlbums (3 handlers)
[GIN-debug] GET    /albums/:id               --> main.getAlbumByID (3 handlers)
[GIN-debug] POST   /albums                   --> main.postAlbums (3 handlers)
[GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
Please check https://github.com/gin-gonic/gin/blob/master/docs/doc.md#dont-trust-all-proxies for details.
[GIN-debug] Listening and serving HTTP on 0.0.0.0:8080
[GIN] 2026/06/03 - 11:19:14 | 404 |  1.219µs |      172.18.0.1 | GET      "/"
[GIN] 2026/06/03 - 11:19:14 | 404 |    778ns |      172.18.0.1 | GET      "/favicon.ico"
[GIN] 2026/06/03 - 11:19:45 | 200 | 147.412µs |      172.18.0.1 | GET      "/albums"

在宿主机测试 API

打开另一个终端，执行：

Bash
curl http://localhost:8080/albums

或直接在浏览器访问 http://localhost:8080/albums。

📸 浏览器显示 JSON 数据，如图4

🧹 九、常用管理命令

操作命令
启动开发容器cd ~/code/go-gin-learning && docker compose up -d
停止容器docker compose down
重新构建镜像docker compose build --no-cache
查看日志docker compose logs -f
进入容器docker exec -it go-gin-learning sh
重启 MySQL/Redis（若需要）cd ~/docker/services && docker compose restart

⚠️ 十、避坑指南

10.1 容器内 git 缺失导致 go run 失败

现象：

Plaintext
unable to resolve git version: exec: "git": executable file not found in $PATH

解决：使用自定义 Dockerfile 安装 git，见第四章。

10.2 MySQL 连接报 TLS/SSL 错误

现象：

Plaintext
ERROR 2026 (HY000): TLS/SSL error: Certificate verification failure

解决：在连接命令中添加 --ssl=0（mariadb）或 --ssl-mode=DISABLED（mysql）。

10.3 容器无法访问 MySQL/Redis

原因：未加入正确的网络，或网络名称写错。

解决：

  • 确认 docker network ls 中有 services_dev-network
  • 检查 docker-compose.yml 中 networks 名称是否完全一致（包括下划线）
  • 在容器内 ping mysql80 测试

10.4 宿主机无法访问 8080 端口

原因：Gin 监听的是 127.0.0.1:8080 而不是 0.0.0.0:8080，导致端口映射失效。

解决：在代码中设置 router.Run(":8080") 或 router.Run("0.0.0.0:8080")。

📝 十一、总结

通过本次实践，我实现了：

  1. ✅ 在 Ubuntu 26.04 上搭建完整的 Go 开发环境
  2. ✅ 利用已有的 MySQL/Redis 容器（独立部署）和自定义网络
  3. ✅ 构建带 git 的 Go 1.26 Alpine 开发镜像
  4. ✅ 编写 docker-compose.yml 挂载代码并接入外部网络
  5. ✅ 在容器内成功运行 Gin 应用并验证数据库连通性

这种“数据库与代码分离容器”的模式非常适合多项目共用基础设施，既节省资源，又保持环境一致性。

下一步，便可以：

  • 在 main.go 中编写连接 MySQL/Redis 的业务逻辑
  • 使用任意代码编辑器（如 VS Code、Sublime 等）直接编辑项目文件，保存后容器内实时同步
  • 将 docker-compose.yml 加入版本控制，与队友共享环境配置

🔗 参考资料

Ubuntu 26.04 下 Chrome 高内存占用优化全记录｜同60标签，Win10≈7GB，Ubuntu暴涨至20GB排坑实录 Ubuntu 打开 Windows 文档提示“无效字符”？我的解决方法

Linux 服务器运维、部署与线上故障排查

如果你的网站或后端服务部署在 Linux 服务器上，遇到访问异常、Nginx 配置问题、MySQL / Redis 异常、Docker 服务不可用、磁盘占满、CPU / 内存过高等问题，可以联系我做一次远程排查。

适合以下场景：
✅ 网站打不开或访问不稳定
✅ Nginx / PHP-FPM 配置异常
✅ MySQL / Redis 性能或连接问题
✅ Docker 服务部署与维护
✅ 服务器迁移与环境配置
✅ CPU / 内存 / 磁盘异常排查

服务内容：
✅ Linux 环境检查
✅ 网站部署与迁移
✅ Nginx / PHP-FPM / MySQL / Redis 排查
✅ Docker 配置与维护
✅ 服务器性能分析
✅ 长期远程运维支持

如需咨询，请联系我，并注明：Linux 运维咨询。

联系方式：
Telegram：@shuijingwan
微信：13980074657
邮箱：shuijingwanwq@gmail.com

评论

2 条对“Ubuntu 26.04 + Docker 搭建 Go Gin 开发环境（全记录）”的回复

  1. 从零到一：在 Trae CN + Docker 中搭建 Go + Gin 开发环境 – 永夜

    […] […]

  2. From Zero to One: Set Up a Go and Gin Development Environment in Trae CN and Docker – Yongye

    […] you have read my previous blog post (such as “Setting Up a Basic Environment with Docker Compose + Go 1.26.4 on Ubuntu 26.04”), you can consider this one the “next chapter”—stringing everything together from […]

更多文章