Docker记述：云服务器记录一-Aet

Bingliaolong 2026-02-18 01:16 Aet | 隐藏边栏 | 抢沙发 | 1 0

文章评分 1 次，平均分 5.0 ：

云服务器相关

规划

/root/apps/

├── nginx-proxy/ # Nginx 反向代理

│ ├── docker-compose.yml

│ ├── nginx.conf

│ ├── conf.d/

│ ├── ssl/

│ └── logs/

├── go-api/ # Go API 服务（以后部署）

├── frontend/ # 前端服务（以后部署）

└── ... # 其他服务

`Nginx`容器

概述

用于反向代理

目录结构

mkdir -p /root/apps/nginx-proxy/conf.d

mkdir -p /root/apps/nginx-proxy/ssl

mkdir -p /root/apps/nginx-proxy/logs

主配置

cat > /root/apps/nginx-proxy/nginx.conf << 'EOF'

user nginx;

worker_processes auto;

error_log /var/log/nginx/error.log warn;

pid /var/run/nginx.pid;

events {

worker_connections 1024;

}

http {

include /etc/nginx/mime.types;

default_type application/octet-stream;

log_format main '$remote_addr - $remote_user [$time_local] "$request" '

'$status $body_bytes_sent "$http_referer" '

'"$http_user_agent" "$http_x_forwarded_for"';

access_log /var/log/nginx/access.log main;

sendfile on;

keepalive_timeout 65;

gzip on;

gzip_types text/plain text/css application/json application/javascript text/xml;

client_max_body_size 50m;

include /etc/nginx/conf.d/*.conf;

}

EOF

默认站点配置

cat > /root/apps/nginx-proxy/conf.d/default.conf << 'EOF'

server {

listen 80 default_server;

server_name _;

# 默认返回一个简单的提示页

location / {

return 200 '{"status":"ok","message":"nginx proxy is running"}';

add_header Content-Type application/json;

}

# 健康检查

location /health {

return 200 'healthy';

add_header Content-Type text/plain;

}

EOF

`API` 的代理配置

cat > /root/apps/nginx-proxy/conf.d/api.conf.bak << 'EOF'

# 重命名为 api.conf 即可生效

server {

listen 80;

server_name api.yourdomain.com; # 改成你的域名或公网IP

location / {

proxy_pass http://host-gateway:8080;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_connect_timeout 60s;

proxy_read_timeout 60s;

proxy_send_timeout 60s;

}

EOF

`Docker Compose` 文件

cat > /root/apps/nginx-proxy/docker-compose.yml << 'EOF'

version: '3.8'

services:

nginx:

image: nginx:alpine

container_name: nginx-proxy

ports:

- "80:80"

- "443:443"

volumes:

- ./nginx.conf:/etc/nginx/nginx.conf:ro

- ./conf.d:/etc/nginx/conf.d:ro

- ./ssl:/etc/nginx/ssl:ro

- ./logs:/var/log/nginx

extra_hosts:

- "host-gateway:host-gateway"

restart: unless-stopped

logging:

driver: json-file

options:

max-size: "10m"

max-file: "3"

EOF

拉取镜像并启动

1 2	cd /root/apps/nginx-proxy docker compose up -d

验证

# 查看容器状态

docker compose ps

# 测试配置是否正确

docker exec nginx-proxy nginx -t

# 测试访问

curl http://localhost

# 应该返回：{"status":"ok","message":"nginx proxy is running"}

curl http://localhost/health

# 应该返回：healthy

域名相关

`DNS` 解析配置

域名管理后台（在哪买的域名就去哪配），添加以下 A 记录：


主机记录	记录类型	记录值
`@`	`A`	服务器公网 `IP`
`www`	`A`	服务器公网 `IP`
`api`	`A`	服务器公网 `IP`

这样就有了三个可用的域名，全部指向你的服务器
1. qqtest.com → 主站
2. www.qqtest.com → 主站
3. api.qqtest.com → API 服务
以后要加新服务，再加一条 A 记录就行
1. 如果服务器在国内，域名需要完成 ICP 备案才能正常访问

把域名配置到 `Nginx`

把域名用到nginx上
修改默认配置

cat > /root/apps/nginx-proxy/conf.d/default.conf << 'EOF'

# 拒绝通过 IP 直接访问（安全）

server {

listen 80 default_server;

server_name _;

return 444;

}

EOF

配置主站

cat > /root/apps/nginx-proxy/conf.d/www.conf << 'EOF'

server {

listen 80;

server_name qqtest.com www.qqtest.com;

# 暂时返回一个欢迎页，以后可以改成代理前端服务

location / {

return 200 '<!DOCTYPE html>

<html>

<head><meta charset="utf-8"><title>qqtest.com</title></head>

<body><h1>Welcome to qqtest.com</h1><p>Site is running.</p></body>

</html>';

add_header Content-Type text/html;

}

location /health {

return 200 'healthy';

add_header Content-Type text/plain;

}

EOF

配置 API 子域名

cat > /root/apps/nginx-proxy/conf.d/api.conf << 'EOF'

server {

listen 80;

server_name api.qqtest.com;

location / {

proxy_pass http://host-gateway:8080;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_connect_timeout 60s;

proxy_read_timeout 60s;

proxy_send_timeout 60s;

}

EOF

检查并重载nginx

# 测试配置是否正确

docker exec nginx-proxy nginx -t

# 重载配置

docker exec nginx-proxy nginx -s reload

`Mysql`容器

目录结构

data/ — MySQL 数据持久化（容器删了数据还在）
conf/ — 自定义配置
logs/ — 日志

mkdir -p /root/apps/mysql/data

mkdir -p /root/apps/mysql/conf

mkdir -p /root/apps/mysql/logs

自定义配置

cat > /root/apps/mysql/conf/my.cnf << 'EOF'

[mysqld]

# 字符集

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci

# 最大连接数

max_connections = 200

# 默认时区（中国）

default-time-zone = '+08:00'

# 日志

slow_query_log = 1

slow_query_log_file = /var/log/mysql/slow.log

long_query_time = 2

# 禁止域名解析（加快连接速度）

skip-name-resolve

# 默认认证插件（兼容旧客户端）

default_authentication_plugin = mysql_native_password

[client]

default-character-set = utf8mb4

[mysql]

default-character-set = utf8mb4

EOF

`Docker Compose` 文件

上面的 MYSQL_ROOT_PASSWORD、MYSQL_USER、MYSQL_PASSWORD 改成自己的密码

cat > /root/apps/mysql/docker-compose.yml << 'EOF'

version: '3.8'

services:

mysql:

image: mysql:8.0

container_name: mysql

ports:

- "3306:3306"

volumes:

# 数据持久化

- ./data:/var/lib/mysql

# 自定义配置

- ./conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro

# 日志

- ./logs:/var/log/mysql

environment:

# ！！！请修改为你自己的密码！！！

MYSQL_ROOT_PASSWORD: YourStrongPassword123!

# 自动创建一个数据库

MYSQL_DATABASE: app_db

# 创建一个普通用户（用于应用连接，不用 root）

MYSQL_USER: app_user

MYSQL_PASSWORD: AppUserPassword123!

TZ: Asia/Shanghai

command:

--default-authentication-plugin=mysql_native_password

restart: unless-stopped

logging:

driver: json-file

options:

max-size: "10m"

max-file: "3"

EOF

拉取镜像并启动

cd /root/apps/mysql

# 启动（第一次会自动拉取镜像并初始化数据库，需要等一两分钟）

docker compose up -d

查看启动状态

看到类似 ready for connections. Version: '8.0.xx' socket: '/var/run/mysqld/mysqld.sock' port: 3306 就说明启动成功了
按 Ctrl+C 退出日志

# 查看容器状态

docker compose ps

# 查看启动日志（确认没有报错）

docker compose logs -f

验证 `MySQL` 能正常使用

输入设置的 MYSQL_ROOT_PASSWORD，进入后测试：

1 2	# 进入 MySQL 容器内部 docker exec -it mysql mysql -u root -p

-- 查看数据库

SHOW DATABASES;

-- 应该能看到 app_db

USE app_db;

-- 查看字符集是否正确

SHOW VARIABLES LIKE 'character_set%';

-- 查看时区

SELECT NOW();

-- 退出

EXIT;

限制远程 `root` 登录

docker exec -it mysql mysql -u root -p

-- 只允许 root 从本地登录

DELETE FROM mysql.user WHERE User='root' AND Host NOT IN ('localhost', '127.0.0.1');

FLUSH PRIVILEGES;

EXIT;

防火墙限制 `3306` 端口

如果你不需要从外部直接连 MySQL（推荐，只让容器内部和宿主机访问）

1	# 修改 docker-compose.yml，把 ports 改为只绑定本机

cat > /root/apps/mysql/docker-compose.yml << 'EOF'

version: '3.8'

services:

mysql:

image: mysql:8.0

container_name: mysql

ports:

# 只绑定本机，外部无法直接访问

- "127.0.0.1:3306:3306"

volumes:

- ./data:/var/lib/mysql

- ./conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro

- ./logs:/var/log/mysql

environment:

MYSQL_ROOT_PASSWORD: YourStrongPassword123!

MYSQL_DATABASE: app_db

MYSQL_USER: app_user

MYSQL_PASSWORD: AppUserPassword123!

TZ: Asia/Shanghai

command:

--default-authentication-plugin=mysql_native_password

restart: unless-stopped

logging:

driver: json-file

options:

max-size: "10m"

max-file: "3"

EOF

重新启动

# 重新启动使配置生效

cd /root/apps/mysql

docker compose down

docker compose up -d

新增服务的流程

流程

# 1. 在 conf.d 下新建一个配置文件

vim /root/apps/nginx-proxy/conf.d/新服务名.conf

# 2. 重载 Nginx

docker exec nginx-proxy nginx -t && docker exec nginx-proxy nginx -s reload

示例
1. 比如以后部署了一个后台管理系统跑在 3000 端口
2. 同时去 DNS 后台加一条 admin 的 A 记录指向服务器 IP 就行
3. 每个服务一个子域名，互不干扰

cat > /root/apps/nginx-proxy/conf.d/admin.conf << 'EOF'

server {

listen 80;

server_name admin.qqtest.com;

location / {

proxy_pass http://host-gateway:3000;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

}

EOF

docker exec nginx-proxy nginx -t && docker exec nginx-proxy nginx -s reload

日常操作速查

cd /root/apps/nginx-proxy

# 新增/修改代理配置后重载

docker exec nginx-proxy nginx -t && docker exec nginx-proxy nginx -s reload

# 查看实时日志

tail -f logs/access.log

# 重启

docker compose restart

# 停止

docker compose down

# 更新 Nginx 镜像版本

docker compose pull

docker compose up -d

问题

服务器拉 `Docker Hub` 镜像超时

配置镜像加速
1. 第一个是腾讯云内网加速
2. 后面两个是备用公共加速源

mkdir -p /etc/docker

cat > /etc/docker/daemon.json << 'EOF'

{

"registry-mirrors": [

"https://mirror.ccs.tencentyun.com",

"https://docker.1ms.run",

"https://docker.xuanyuan.me"

]

}

EOF

重启 Docker 使配置生效

1 2	systemctl daemon-reload systemctl restart docker

验证加速是否生效
1. 能看到你配置的镜像地址就说明生效了

1	docker info \| grep -A 5 "Registry Mirrors"

重新拉取 Nginx 并启动

1 2	cd /root/apps/nginx-proxy docker compose up -d

服务器`pull`代码失败

服务器上生成 SSH 密钥

1 2	ssh-keygen -t ed25519 -C "your-email@example.com" # 一路回车，不设密码

查看并复制公钥

1	cat ~/.ssh/id_ed25519.pub

添加到github
1. Settings → SSH and GPG Keys → New SSH Key → 粘贴 → Add
测试连接

# Gitee

ssh -T git@gitee.com

# GitHub

ssh -T git@github.com

阿里云镜像源访问不了

先测试哪个源能用：

1	docker pull golang:1.22-alpine

如果能拉下来，说明之前配的镜像加速源已经生效了，直接把 Dockerfile 里的阿里云前缀去掉就行：

1 2	sed -i 's\|registry.cn-hangzhou.aliyuncs.com/library/golang\|golang\|g' Dockerfile sed -i 's\|registry.cn-hangzhou.aliyuncs.com/library/alpine\|alpine\|g' Dockerfile

`api`容器连不上 `mysql` 容器

先排查 MySQL 是否正常运行：
1. 发现在运行

1 2	# 看 MySQL 容器是否在跑 docker ps \| grep mysql

如果 MySQL 在运行，问题出在网络连接方式上
1. 如果显示 127.0.0.1:3306，说明 MySQL 只绑定了本机回环地址
2. 容器内的 host-gateway 走的不是 127.0.0.1，所以连不上

1 2	# 看 MySQL 监听的是什么地址 docker port mysql

解决
1. 让两个容器共用 Docker 网络
2. 详见两个容器共用 Docker 网络

两个容器共用 `Docker` 网络

创建一个共享网络

1	docker network create app-network

修改 MySQL 的 docker-compose.yml
1. 添加了networks
2. 重启mysql

1	vim /root/apps/mysql/docker-compose.yml

services:

mysql:

image: mysql:8.0

container_name: mysql

ports:

- "127.0.0.1:3306:3306"

volumes:

- ./data:/var/lib/mysql

- ./conf/my.cnf:/etc/mysql/conf.d/my.cnf:ro

- ./logs:/var/log/mysql

environment:

MYSQL_ROOT_PASSWORD: YourStrongPassword123!

MYSQL_DATABASE: app_db

MYSQL_USER: app_user

MYSQL_PASSWORD: AppUserPassword123!

TZ: Asia/Shanghai

command:

--default-authentication-plugin=mysql_native_password

restart: unless-stopped

networks:

- app-network

networks:

app-network:

external: true

cd /root/apps/mysql

docker compose down

docker compose up -d

修改 Go API 的 docker-compose.yml
1. 修改DB_HOST
2. 添加了networks
3. 重新构建启动

1	vim /root/apps/go_api_service/docker-compose.yml

services:

go-api:

build:

context: .

dockerfile: Dockerfile

container_name: go-api

ports:

- "127.0.0.1:8080:8080"

environment:

# 关键：用 MySQL 容器名作为 host

DB_HOST: mysql

DB_PORT: "3306"

DB_USER: app_user

DB_PASSWORD: AppUserPassword123!

DB_NAME: app_db

SERVER_PORT: "8080"

SERVER_ENV: production

SERVER_NAME: go-api-server

TZ: Asia/Shanghai

restart: unless-stopped

networks:

- app-network

networks:

app-network:

external: true

1 2	cd /root/apps/go_api_service docker compose up -d --build

请求显示`502 Bad Gateway`

502 说明 Nginx 收到了请求，但转发到后端失败了
1. 在服务器可以访问

# 1. Go API 容器在跑吗？

docker ps | grep go-api

# 2. Go API 能直接访问吗？

curl http://127.0.0.1:8080/api/health

第 2 步返回正常，说明问题在 Nginx 转发到 Go API 这一段
1. 之前配置里用的是 proxy_pass http://host-gateway:8080
2. 但 Nginx 容器可能没加入 app-network，也解析不了 host-gateway
修改 Nginx 的 docker-compose.yml
1. 添加了networks

cat > /root/apps/nginx-proxy/docker-compose.yml << 'EOF'

services:

nginx:

image: nginx:alpine

container_name: nginx-proxy

ports:

- "80:80"

- "443:443"

volumes:

- ./nginx.conf:/etc/nginx/nginx.conf:ro

- ./conf.d:/etc/nginx/conf.d:ro

- ./ssl:/etc/nginx/ssl:ro

- ./logs:/var/log/nginx

restart: unless-stopped

networks:

- app-network

logging:

driver: json-file

options:

max-size: "10m"

max-file: "3"

networks:

app-network:

external: true

EOF

修改 api.conf，用容器名代替 host-gateway
1. proxy_pass

cat > /root/apps/nginx-proxy/conf.d/api.conf << 'EOF'

server {

listen 80;

server_name api.qqtest.com;

location / {

proxy_pass http://go-api:8080;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

proxy_set_header X-Forwarded-Proto $scheme;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_connect_timeout 60s;

proxy_read_timeout 60s;

proxy_send_timeout 60s;

}

EOF

同时修改 Go API 的端口绑定
1. 既然走 Docker 网络了，Go API 就不需要绑定宿主机端口了

cat > /root/apps/go_api_service/docker-compose.yml << 'EOF'

services:

go-api:

build:

context: .

dockerfile: Dockerfile

container_name: go-api

expose:

- "8080"

environment:

DB_HOST: mysql

DB_PORT: "3306"

DB_USER: app_user

DB_PASSWORD: AppUserPassword123!

DB_NAME: app_db

SERVER_PORT: "8080"

SERVER_ENV: production

SERVER_NAME: go-api-server

TZ: Asia/Shanghai

restart: unless-stopped

networks:

- app-network

networks:

app-network:

external: true

EOF

云服务器相关
规划
Nginx容器
概述
目录结构
主配置
默认站点配置
API 的代理配置
Docker Compose 文件
拉取镜像并启动
验证
域名相关
DNS 解析配置
把域名配置到 Nginx
Mysql容器
目录结构
自定义配置
Docker Compose 文件
拉取镜像并启动
查看启动状态
验证 MySQL 能正常使用
限制远程 root 登录
防火墙限制 3306 端口
重新启动
新增服务的流程
日常操作速查
问题
服务器拉 Docker Hub 镜像超时
服务器pull代码失败
阿里云镜像源访问不了
api容器连不上 mysql 容器
两个容器共用 Docker 网络
请求显示502 Bad Gateway

dns docker go go-service mysql nginx

声明：本文为原创文章，版权归Aet所有，欢迎分享本文，转载请保留出处！

Bingliaolong 关注：0 粉丝：0

Everything will be better.

你可能也喜欢

热评文章

1Docker记述一 0

云服务器相关

规划

`Nginx`容器

概述

目录结构

主配置

默认站点配置

`API` 的代理配置

`Docker Compose` 文件

拉取镜像并启动

验证

域名相关

`DNS` 解析配置

把域名配置到 `Nginx`

`Mysql`容器

目录结构

自定义配置

`Docker Compose` 文件

拉取镜像并启动

查看启动状态

验证 `MySQL` 能正常使用

限制远程 `root` 登录

防火墙限制 `3306` 端口

重新启动

新增服务的流程

日常操作速查

问题

服务器拉 `Docker Hub` 镜像超时

服务器`pull`代码失败

阿里云镜像源访问不了

`api`容器连不上 `mysql` 容器

两个容器共用 `Docker` 网络

请求显示`502 Bad Gateway`

你可能也喜欢

热评文章

发表评论

标签云集

Docker记述：云服务器记录一

云服务器相关

规划

Nginx容器

概述

目录结构

主配置

默认站点配置

API 的代理配置

Docker Compose 文件

拉取镜像并启动

验证

域名相关

DNS 解析配置

把域名配置到 Nginx

Mysql容器

目录结构

自定义配置

Docker Compose 文件

拉取镜像并启动

查看启动状态

验证 MySQL 能正常使用

限制远程 root 登录

防火墙限制 3306 端口

重新启动

新增服务的流程

日常操作速查

问题

服务器拉 Docker Hub 镜像超时

服务器pull代码失败

阿里云镜像源访问不了

api容器连不上 mysql 容器

两个容器共用 Docker 网络

请求显示502 Bad Gateway

你可能也喜欢

热评文章

发表评论

标签云集

`Nginx`容器

`API` 的代理配置

`Docker Compose` 文件

`DNS` 解析配置

把域名配置到 `Nginx`

`Mysql`容器

`Docker Compose` 文件

验证 `MySQL` 能正常使用

限制远程 `root` 登录

防火墙限制 `3306` 端口

服务器拉 `Docker Hub` 镜像超时

服务器`pull`代码失败

`api`容器连不上 `mysql` 容器

两个容器共用 `Docker` 网络

请求显示`502 Bad Gateway`