如何在Debian上构建Golang镜像

在Debian上搞Golang镜像，听起来有点绕，但其实就那么几步。只要你把Docker和Git装好，剩下的就是按部就班地写个Dockerfile、打包、运行，最后看看日志。下面直接上干货，省得你到处翻文档。

第一步：装好基础工具

Debian上干这事儿，docker和git是必需品。如果你还没装，终端里跑这两行就行：

sudo apt update
sudo apt install docker.io git

别担心版本问题，apt源里的稳定版足够用。装完记得把当前用户加到docker组，免得每次都要sudo——当然，这是后话。

第二步：写Dockerfile

在你的项目根目录下新建一个Dockerfile文件，内容参考下面这个经典模板：

# 基于官方Golang镜像
FROM golang:latest

# 容器内工作目录
WORKDIR /app

# 把当前目录所有文件复制进去
COPY . .

# 编译Go应用
RUN go build -o myapp .

# 容器启动时运行
CMD ["./myapp"]

注意这里的golang:latest是官方最新版，如果你对版本有要求，可以换成golang:1.21之类的具体标签。另外，实际项目中通常会加.dockerignore文件来排除不必要的文件，这里先不展开。

第三步：构建镜像

在Dockerfile所在目录执行：

docker build -t my-golang-app .

-t就是给你的镜像起个名字（标签），后面的点告诉Docker当前目录就是构建上下文。构建过程会拉取基础镜像、复制代码、编译……耐心等一会儿就行。

第四步：跑起来

镜像构建成功，直接启动容器：

docker run -p 8080:8080 my-golang-app

-p 8080:8080把容器内的8080端口映射到宿主机的8080端口。如果你的Go应用监听的是其他端口（比如3000），记得改过来。

第五步：看日志

运行时如果遇到问题或者想看看输出，先查一下容器ID：

docker ps

拿到容器ID后，用下面命令看日志：

docker logs 

这能帮你快速定位错误，比如编译失败、端口冲突之类的常见坑。

以上流程基本覆盖了从零开始构建Golang镜像并运行容器的完整套路。实际生产中，你可能还需要考虑多阶段构建来缩小镜像体积、使用docker-compose编排多个服务，或者配置CI/CD自动构建。不过那是进阶话题了，先把基础跑通再说。