如何在腾讯云轻量服务器Ubuntu系统上快速搭建Docker环境?

在腾讯云轻量应用服务器(Lighthouse)上跑 Ubuntu 装 Docker,其实是个非常经典且稳定的组合。轻量服务器的优势在于网络直连、带宽性价比高,劣势通常是默认安全组策略比较保守,以及内存可能较小(比如 1核1G 或 2核4G)。

下面是一套经过验证的“防坑”流程,按步骤来,基本不会翻车。

第一步:前置准备与系统更新

登录 SSH 后,别急着装 Docker,先确保系统是最新的,尤其是内核和基础依赖包。很多报错都是因为 apt 源缓存或者旧版本冲突导致的。

# 更新软件包列表
sudo apt update

# 升级已安装的软件(可选,但推荐)
sudo apt upgrade -y

# 安装 Docker 所需的依赖库
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release

第二步:添加官方 GPG 密钥和 APT 源

不要直接用 apt install docker.io,那个是 Ubuntu 社区维护的版本,往往不是最新稳定版,且路径和配置习惯跟官方文档对不上。建议用腾讯云的官方源或者 Docker 官方源。考虑到国内访问速度,这里推荐直接使用 Docker 官方提供的脚本一键安装,或者手动配置源。

方法一:官方一键脚本(最快,适合新手)

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

注:加上 --mirror Aliyun 可以提速下载过程,避免超时。

方法二:手动配置源(更可控,推荐老手)

如果你担心脚本安全性,或者需要指定特定版本,手动配更稳妥:

  1. 添加 Docker 官方 GPG 密钥:

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  2. 设置稳定版仓库:

    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  3. 再次更新并安装:

    sudo apt update
    sudo apt install -y docker-ce docker-ce-cli containerd.io

第三步:启动服务并设置开机自启

安装完成后,服务通常不会自动启动,需要手动拉起。

# 启动 Docker 服务
sudo systemctl start docker

# 设置为开机自启
sudo systemctl enable docker

# 检查状态,看到 active (running) 就对了
sudo systemctl status docker

第四步:免 sudo 运行 Docker(重要!)

默认情况下,执行 docker ps 等命令需要加 sudo,这很麻烦。创建一个 docker 用户组,并将当前用户加入其中。

# 创建 docker 组(如果不存在)
sudo groupadd docker

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER

# 重新加载会话权限(或者注销重登)
newgrp docker

现在你可以直接运行 docker ps 而不需要 sudo 了。

第五步:配置镜像提速器(关键步骤)

在国内,直接拉取 Docker Hub 的镜像可能会慢到怀疑人生,甚至超时失败。这一步不做,后面体验极差。

腾讯云轻量服务器本身有内网优势,但 Docker 默认走公网。建议配置阿里云或腾讯云的镜像提速器。

以阿里云为例(通用性强):

  1. 编辑 /etc/docker/daemon.json 文件:

    sudo nano /etc/docker/daemon.json
  2. 写入以下内容(注意 JSON 格式,逗号别漏):

    {
      "registry-mirrors": [
        "https://<你的阿里云专属提速地址>.mirror.aliyuncs.com"
      ]
    }

    如果你没有阿里云账号,也可以用腾讯云自己的镜像提速,或者使用一些公开的社区镜像源,但稳定性不如大厂专属提速。

  3. 重启 Docker 服务使配置生效:

    sudo systemctl daemon-reload
    sudo systemctl restart docker

第六步:防火墙与安全组配置

这是最容易忽略的一步。Docker 容器内部署的服务(如 Web 应用)需要对外暴露端口。

  1. Ubuntu 本地防火墙(UFW):
    轻量服务器默认可能开启了 UFW。如果没开,跳过;如果开了,记得放行对应端口。

    # 查看 UFW 状态
    ufw status
    
    # 假设你要运行一个 Web 服务在 8080 端口
    sudo ufw allow 8080/tcp
    sudo ufw reload
  2. 腾讯云控制台安全组:
    登录腾讯云控制台 -> 轻量应用服务器 -> 防火墙/安全组。
    必须在这里添加入方向规则,放行你需要的端口(如 80, 443, 8080 等),否则即使容器跑起来了,网络也访问不了。

第七步:验证与测试

一切就绪后,跑个经典的 Hello World 验证一下:

docker run hello-world

如果能打印出欢迎信息,说明环境搭建成功。

常见问题排查(避坑指南)

  1. 内存不足导致 Docker 崩溃:
    如果你的轻量服务器是 1核1G 或更低,运行 Docker 时务必注意内存管理。建议在系统层面增加 Swap 分区,防止 OOM(Out of Memory)。

    # 创建 2GB swap 文件
    sudo fallocate -l 2G /swapfile
    sudo chmod 600 /swapfile
    sudo mkswap /swapfile
    sudo swapon /swapfile
    # 永久生效需写入 fstab
    echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
  2. 容器无法联网:
    检查 docker network ls,确保使用的是默认的 bridge 网络。有时防火墙规则会拦截容器的 DNS 解析,可以尝试在 daemon.json 中指定 DNS:

    {
      "dns": ["8.8.8.8", "114.114.114.114"]
    }

    修改后重启 Docker 服务。

  3. 权限问题:
    如果遇到 permission denied,检查是不是文件所有者问题,或者是否正确地加入了 docker 用户组。

按照这个流程走,你在腾讯云轻量服务器上搭建的 Docker 环境应该是稳定且高效的。后续如果想部署 Nginx、MySQL 或 Redis,直接 docker pull 然后 docker run 即可,配合 docker-compose 管理多容器会更香。

未经允许不得转载:CLOUD云枢 » 如何在腾讯云轻量服务器Ubuntu系统上快速搭建Docker环境?