下面以腾讯云轻量应用服务器(Lighthouse)为例,分步骤说明:安装 Docker + 部署项目。假设你使用的是 Ubuntu 20.04/22.04(CentOS 类似,但命令略有不同)。
一、登录并准备环境
-
登录腾讯云控制台 → 轻量应用服务器 → 选择你的实例 → 点击“远程连接”或使用 SSH 工具(如 Terminal / Xshell / PuTTY):
ssh root@<你的公网IP>输入密码或密钥登录。
-
更新系统包(推荐):
# Ubuntu/Debian apt update && apt upgrade -y # CentOS/RHEL yum update -y
二、安装 Docker(Ubuntu 示例)
方案 A:使用官方 Docker 仓库(推荐)
-
安装依赖:
apt install -y ca-certificates curl gnupg lsb-release -
添加 Docker 官方 GPG 密钥:
mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg chmod a+r /etc/apt/keyrings/docker.gpg -
设置 Docker 软件源:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null -
安装 Docker Engine:
apt update apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -
启动并设置开机自启:
systemctl enable --now docker -
验证安装:
docker --version docker run hello-world -
(可选)将当前用户加入 docker 组,避免每次用 sudo:
usermod -aG docker $USER newgrp docker
CentOS 安装方式类似,只是包名和源不同,可用
yum install docker-ce docker-ce-cli containerd.io等。
三、安装 Docker Compose(如果项目用 compose)
Docker Desktop 已内置 docker compose,但 CLI 版本可能需要单独安装:
apt install -y docker-compose-plugin
# 或者旧版:
# apt install -y docker-compose
验证:
docker compose version
四、上传项目到服务器
常见方式有几种:
方式 1:Git 拉取
在服务器上执行:
cd ~
git clone <你的代码仓库地址>
cd <项目目录>
方式 2:SCP / SFTP 上传
本地终端:
scp -r ./your-project root@<服务器IP>:/root/your-project
或在 FileZilla 等工具中通过 SFTP 上传。
方式 3:直接使用 tar 打包上传后解压
本地打包:
tar czf project.tar.gz your-project/
本地上传:
scp project.tar.gz root@<服务器IP>:/root/
服务器解压:
cd /root
tar xzf project.tar.gz
五、配置项目(以 Docker Compose 为例)
假设项目根目录下已有 docker-compose.yml,例如:
version: "3.8"
services:
web:
build: .
ports:
- "8080:80"
environment:
- ENV=production
restart: always
1. 构建并启动服务
在项目目录下执行:
docker compose up -d --build
查看日志:
docker compose logs -f
停止服务:
docker compose down
2. 若没有 docker-compose.yml,需自行编写
简单示例(Node.js + Nginx):
Dockerfile(项目根目录):
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 3000
CMD ["node", "index.js"]
docker-compose.yml:
version: "3.8"
services:
app:
build: .
ports:
- "3000:3000"
restart: always
environment:
NODE_ENV: production
然后:
docker compose up -d --build
六、开放安全组端口
轻量应用服务器默认只开放部分端口,需要手动放行:
- 登录腾讯云控制台 → 轻量应用服务器 → 选择实例 → “安全组”。
- 编辑安全组规则,添加入站规则:
- 协议:TCP
- 端口:你的项目端口(如 8080、3000、22 等)
- 来源:0.0.0.0/0(生产环境建议限制为特定 IP)
- 保存规则。
七、访问项目
浏览器访问:
http://<你的公网IP>:<映射端口>
例如:http://123.123.123.123:8080
八、常见问题排查
-
容器无法启动
- 查看日志:
docker compose logs <服务名>或docker logs <容器ID> - 检查端口冲突:
netstat -tlnp或ss -tlnp
- 查看日志:
-
权限问题
- 文件权限:
chmod -R 755 /path/to/project - 数据卷权限:确保挂载目录对容器内用户可读写。
- 文件权限:
-
网络不通
- 确认安全组规则已放行对应端口。
- 检查防火墙:
ufw status(Ubuntu)或firewall-cmd --list-all(CentOS)。
如果你能提供:
- 操作系统版本(如 Ubuntu 22.04 / CentOS 7)
- 项目类型(Java/Spring、Node.js、Python、Go 等)
- 是否已有
docker-compose.yml或 Dockerfile
我可以给你一份更贴合你项目的具体部署命令和示例配置。
CLOUD技术博