Docker on heyaohua's Bloghttps://blog.heyaohua.com/tags/docker/Recent content in Docker on heyaohua's Blogheyaohua's Bloghttps://blog.heyaohua.com/og-image.pnghttps://blog.heyaohua.com/og-image.pngHugozh-cnThu, 09 Oct 2025 12:30:00 +0800Dify + Cloudflare Tunnel 部署指南https://blog.heyaohua.com/posts/2025/10/dify-cloudflare-tunnel-deployment/Thu, 09 Oct 2025 12:30:00 +0800https://blog.heyaohua.com/posts/2025/10/dify-cloudflare-tunnel-deployment/本指南详细介绍如何使用 Docker 部署 Dify，并通过 Cloudflare Tunnel 实现安全的外网访问。本指南详细介绍如何使用 Docker 部署 Dify，并通过 Cloudflare Tunnel 实现安全的外网访问。

前置条件

  • macOS 系统
  • 已安装 Docker 和 Docker Compose
  • 拥有 Cloudflare 账户
  • 拥有一个域名并托管在 Cloudflare

第一步：部署 Dify

1.1 克隆 Dify 仓库

cd /Users/heyaohua/Server
git clone https://github.com/langgenius/dify.git
cd dify/docker

1.2 配置环境变量

# 复制环境变量模板
cp .env.example .env

# 编辑环境变量文件
vim .env

关键配置项：

  • SECRET_KEY: 生成一个安全的密钥
  • DB_USERNAME, DB_PASSWORD: 数据库用户名和密码
  • REDIS_PASSWORD: Redis 密码

1.3 启动 Dify 服务

# 启动所有服务
docker-compose up -d

# 检查服务状态
docker-compose ps

确保以下服务正常运行：

  • docker-nginx-1: 端口 80, 443
  • docker-api-1: 端口 5001
  • docker-web-1: 端口 3000
  • docker-plugin_daemon-1: 端口 5003

第二步：安装 Cloudflare Tunnel

2.1 安装 cloudflared

# 使用 Homebrew 安装
brew install cloudflared

2.2 登录 Cloudflare

cloudflared tunnel login

这会打开浏览器，选择要使用的域名进行授权。

第三步：创建和配置 Tunnel

3.1 创建 Tunnel

# 创建名为 dify-tunnel 的隧道
cloudflared tunnel create dify-tunnel

记录返回的 Tunnel ID，例如：e5e75674-d270-4201-ab9e-ea858c091d91

3.2 创建配置文件

在 Dify docker 目录下创建 config.yaml：

tunnel: e5e75674-d270-4201-ab9e-ea858c091d91
credentials-file: /Users/heyaohua/.cloudflared/e5e75674-d270-4201-ab9e-ea858c091d91.json

ingress:
  - hostname: dify.yourdomain.com
    service: http://127.0.0.1:80
  - service: http_status:404

重要说明：

  • 将 tunnel 值替换为你的实际 Tunnel ID
  • 将 credentials-file 路径中的 ID 替换为你的实际 Tunnel ID
  • 将 dify.yourdomain.com 替换为你的实际域名

3.3 配置 DNS 记录

# 为域名创建 DNS 记录（如果不存在）
cloudflared tunnel route dns dify-tunnel dify.yourdomain.com

如果提示记录已存在，可以跳过此步骤。

第四步：测试 Tunnel 连接

4.1 手动测试

# 设置 DNS 解析并启动隧道
cd /Users/heyaohua/Server/Dify/docker
GODNS=1.1.1.1 cloudflared tunnel --config config.yaml run

4.2 验证连接

在浏览器中访问 https://dify.yourdomain.com，确认可以正常访问 Dify 界面。

第五步：配置系统服务（后台运行）

5.1 安装基础服务

cloudflared service install

5.2 创建自定义服务配置

创建 com.cloudflare.cloudflared.plist 文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
        <dict>
                <key>Label</key>
                <string>com.cloudflare.cloudflared</string>
                <key>ProgramArguments</key>
                <array>
                        <string>/opt/homebrew/bin/cloudflared</string>
                        <string>tunnel</string>
                        <string>--config</string>
                        <string>/Users/heyaohua/Server/Dify/docker/config.yaml</string>
                        <string>run</string>
                </array>
                <key>RunAtLoad</key>
                <true/>
                <key>StandardOutPath</key>
                <string>/Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.out.log</string>
                <key>StandardErrorPath</key>
                <string>/Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.err.log</string>
                <key>KeepAlive</key>
                <dict>
                        <key>SuccessfulExit</key>
                        <false/>
                </dict>
                <key>ThrottleInterval</key>
                <integer>5</integer>
                <key>EnvironmentVariables</key>
                <dict>
                        <key>GODNS</key>
                        <string>1.1.1.1</string>
                </dict>
        </dict>
</plist>

注意： 将配置文件路径替换为你的实际路径。

5.3 安装和启动服务

# 复制配置文件到 LaunchAgents 目录
cp com.cloudflare.cloudflared.plist /Users/heyaohua/Library/LaunchAgents/

# 卸载旧服务（如果存在）
launchctl unload /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

# 加载新服务
launchctl bootstrap gui/$(id -u) /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

5.4 验证服务状态

# 检查服务是否运行
launchctl list | grep cloudflared

# 查看服务日志
tail -f /Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.err.log

服务管理命令

启动服务

launchctl bootstrap gui/$(id -u) /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

停止服务

launchctl bootout gui/$(id -u) /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

查看服务状态

launchctl list | grep cloudflared

查看实时日志

# 查看输出日志
tail -f /Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.out.log

# 查看错误日志
tail -f /Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.err.log

故障排除

1. DNS 解析问题

如果遇到 DNS 解析错误：

# 临时使用 Cloudflare DNS
GODNS=1.1.1.1 cloudflared tunnel --config config.yaml run

2. 端口冲突

确保本地 80 端口没有被其他服务占用：

# 检查端口占用
lsof -i :80

# 检查 Docker 服务状态
docker-compose ps

3. 权限问题

确保 cloudflared 有足够的权限访问配置文件和日志目录。

4. 服务无法启动

检查配置文件路径是否正确，Tunnel ID 是否匹配。

安全建议

  1. 定期更新: 保持 Dify 和 cloudflared 为最新版本
  2. 访问控制: 在 Cloudflare 控制台配置访问策略
  3. 监控日志: 定期检查服务日志，监控异常访问
  4. 备份配置: 备份重要的配置文件和数据库

总结

完成以上步骤后，你将拥有：

  • ✅ 完全部署的 Dify 服务
  • ✅ 通过 HTTPS 的安全外网访问
  • ✅ 自动启动的后台服务
  • ✅ 完整的日志记录和监控

现在你可以通过 https://dify.yourdomain.com 安全地访问你的 Dify 服务，无需担心服务器重启或网络中断的问题。

创建时间: 2025年10月9日 适用版本: Dify latest, cloudflared 2025.9.1 系统要求: macOS with Docker

]]>PostgreSQL Docker 部署常见问题与解决方案https://blog.heyaohua.com/posts/2025/10/postgresql-docker-faq/Thu, 09 Oct 2025 12:05:00 +0800https://blog.heyaohua.com/posts/2025/10/postgresql-docker-faq/汇总在使用 Docker 部署 PostgreSQL（含 PostGIS、pgvector、TimescaleDB）过程中常见的问题及可操作的解决方案，涵盖构建、扩展、连接、权限、性能与数据等方面。汇总在使用 Docker 部署 PostgreSQL（含 PostGIS、pgvector、TimescaleDB）过程中常见的问题及可操作的解决方案，涵盖构建、扩展、连接、权限、性能与数据等方面。

目录

  • 构建问题
  • 扩展问题
  • 连接问题
  • 权限问题
  • 性能问题
  • 数据问题
  • 调试技巧
  • 预防措施
  • 获取帮助

构建问题

Q1: Docker 构建时出现 “lsb_release: command not found”

问题描述：

/bin/sh: 1: lsb_release: command not found
/bin/sh: 1: apt-key: command not found

原因分析： 在 Debian/Ubuntu 基础镜像中，lsb_release 和 apt-key 命令可能不存在或已被弃用。

解决方案：改用从源码编译的方式安装 TimescaleDB：

# 不使用包管理器安装，改为源码编译
RUN cd /tmp && \
    git clone https://github.com/timescale/timescaledb.git && \
    cd timescaledb && \
    git checkout 2.13.0 && \
    ./bootstrap && \
    cd build && \
    make && \
    make install

Q2: 编译时出现 “gssapi/gssapi.h: No such file or directory”

问题描述：

fatal error: gssapi/gssapi.h: No such file or directory

原因分析：缺少 GSSAPI 开发库，TimescaleDB 编译需要 Kerberos 相关依赖。

解决方案：在 Dockerfile 中添加必要的依赖包：

RUN apt-get update && apt-get install -y \
    build-essential \
    postgresql-server-dev-15 \
    cmake \
    git \
    wget \
    ca-certificates \
    libkrb5-dev \
    libgssapi-krb5-2 \
    && rm -rf /var/lib/apt/lists/*

扩展问题

Q3: pgvector 出现段错误 (Segmentation Fault)

问题描述：

server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.

原因分析：

  • pgvector 最新版本可能与 PostgreSQL 15 存在兼容性问题
  • 编译环境或依赖版本不匹配

解决方案：使用稳定的预编译版本：

# 使用 pgvector 0.5.1 版本，避免段错误
RUN cd /tmp && \
    wget https://github.com/pgvector/pgvector/archive/v0.5.1.tar.gz && \
    tar -xzf v0.5.1.tar.gz && \
    cd pgvector-0.5.1 && \
    make && \
    make install

Q4: TimescaleDB 扩展创建失败

问题描述：

ERROR: could not load library "timescaledb":
shared_preload_libraries not configured

原因分析：TimescaleDB 需要在 PostgreSQL 启动时预加载。

解决方案：在 Dockerfile 中配置预加载库：

RUN echo "shared_preload_libraries = 'timescaledb'" >> /usr/share/postgresql/postgresql.conf.sample

Q5: PostGIS 扩展版本不匹配

问题描述：

ERROR: extension "postgis" has no installation candidate

原因分析：PostgreSQL 版本与 PostGIS 包版本不匹配。

解决方案：明确指定对应版本的包：

RUN apt-get install -y \
    postgresql-15-postgis-3 \
    postgresql-15-postgis-3-scripts

连接问题

Q6: IDE 连接提示 “Connection refused”

问题描述：

connection to server at "localhost" (::1), port 5432 failed: Connection refused

原因分析：

  • 端口映射不正确
  • 服务未完全启动
  • 防火墙阻止连接

解决方案：

  1. 检查端口映射：
docker port postgres-all-extensions
# 应该显示: 5432/tcp -> 0.0.0.0:5432
  1. 确认服务状态：
docker ps
# 检查容器是否正常运行
  1. 等待服务完全启动：
docker logs postgres-all-extensions
# 查看启动日志，确认数据库已就绪

Q7: 密码认证失败

问题描述：

FATAL: password authentication failed for user "postgres"

原因分析：

  • 数据目录已存在，使用了旧密码初始化
  • 环境变量未正确加载
  • pg_hba.conf 配置问题

解决方案：

  1. 清理旧数据重新初始化：
docker-compose down
sudo rm -rf ./data/pgdata/*
docker-compose up -d
  1. 检查环境变量：
docker exec postgres-all-extensions env | grep POSTGRES
  1. 验证 .env 文件格式：
# 确保 .env 文件在正确位置且格式正确
POSTGRES_PASSWORD=your_password

权限问题

Q8: 数据目录权限错误

问题描述：

initdb: error: could not create directory "/var/lib/postgresql/data": Permission denied

原因分析：宿主机目录权限不正确，PostgreSQL 容器无法写入。

解决方案：

# 修改目录权限
sudo chown -R 999:999 ./data/pgdata
# 或者删除目录让 Docker 自动创建
sudo rm -rf ./data/pgdata

Q9: 配置文件权限问题

问题描述：容器启动时无法读取配置文件。

解决方案：

# 确保配置文件可读
chmod 644 config/postgresql.conf
chmod 644 config/pg_hba.conf

性能问题

Q10: 容器启动缓慢

问题描述：Docker 容器启动时间过长。

原因分析：

  • 数据库初始化需要时间
  • 扩展安装和配置耗时
  • 系统资源不足

解决方案：

  1. 增加启动等待时间：
# 等待更长时间再进行连接测试
sleep 15 && docker exec postgres-all-extensions psql -U postgres -c "SELECT 1;"
  1. 优化 Docker 资源分配：
# 在 docker-compose.yml 中添加资源限制
deploy:
  resources:
    limits:
      memory: 2G
    reservations:
      memory: 1G

Q11: 查询性能差

问题描述：数据库查询响应缓慢。

解决方案：

  1. 调整 PostgreSQL 配置：
-- 增加共享缓冲区
ALTER SYSTEM SET shared_buffers = '256MB';
-- 调整工作内存
ALTER SYSTEM SET work_mem = '4MB';
-- 重载配置
SELECT pg_reload_conf();
  1. 创建适当的索引：
-- 为向量查询创建索引
CREATE INDEX ON items USING ivfflat (embedding vector_cosine_ops);
-- 为时序数据创建索引
CREATE INDEX ON sensor_data (time DESC);

数据问题

Q12: 数据持久化失败

问题描述：容器重启后数据丢失。

原因分析：

  • 卷映射配置错误
  • 数据目录路径不正确

解决方案：确认 docker-compose.yml 中的卷配置：

volumes:
  - ./data/pgdata:/var/lib/postgresql/data

Q13: 数据库版本不兼容

问题描述：

FATAL: database files are incompatible with server

原因分析：数据目录由不同版本的 PostgreSQL 创建。

解决方案：

  1. 备份数据：
docker exec postgres-old pg_dumpall -U postgres > backup.sql
  1. 清理数据目录：
sudo rm -rf ./data/pgdata/*
  1. 重新启动并恢复：
docker-compose up -d
# 等待启动完成后
docker exec -i postgres-all-extensions psql -U postgres < backup.sql

调试技巧

查看详细日志

# 查看容器日志
docker logs postgres-all-extensions -f

# 查看 PostgreSQL 日志
docker exec postgres-all-extensions tail -f /var/log/postgresql/postgresql.log

进入容器调试

# 进入容器
docker exec -it postgres-all-extensions bash

# 查看进程状态
ps aux | grep postgres

# 检查扩展安装
psql -U postgres -c "\dx"

网络连接测试

# 测试端口连通性
telnet localhost 5432

# 使用 Docker 网络测试
docker run --rm --network host postgres:15 pg_isready -h localhost -p 5432

预防措施

  1. 定期备份：建立自动化备份策略
  2. 监控日志：定期检查错误日志
  3. 版本管理：记录使用的具体版本号
  4. 测试环境：在生产部署前充分测试
  5. 文档更新：及时更新配置和问题解决方案

获取帮助

如遇到本文未涵盖的问题：

  1. 查看官方文档：
  2. PostgreSQL 官方文档
  3. PostGIS 文档
  4. pgvector GitHub

TimescaleDB 文档

社区支持：

  1. PostgreSQL 邮件列表
  2. Stack Overflow

GitHub Issues

日志分析：

  1. 详细记录错误信息
  2. 提供完整的错误日志
  3. 说明环境配置信息
]]>PostgreSQL Docker 部署指南https://blog.heyaohua.com/posts/2025/10/postgresql-docker-deployment-guide/Thu, 09 Oct 2025 12:00:00 +0800https://blog.heyaohua.com/posts/2025/10/postgresql-docker-deployment-guide/本指南详细介绍如何使用 Docker 部署一个包含 PostGIS、pgvector 和 TimescaleDB 扩展的 PostgreSQL 15 数据库。该方案解决了扩展兼容性问题，特别是 pgvector 的段错误问题。本指南详细介绍如何使用 Docker 部署一个包含 PostGIS、pgvector 和 TimescaleDB 扩展的 PostgreSQL 15 数据库。该方案解决了扩展兼容性问题，特别是 pgvector 的段错误问题。

项目结构

PgSQL/
├── .env                          # 环境变量配置
├── Dockerfile                    # PostgreSQL 镜像构建文件
├── docker-compose.yml            # Docker Compose 配置
├── README.md                     # 项目说明
├── config/                       # 配置文件目录
│   ├── pg_hba.conf              # 客户端认证配置
│   └── postgresql.conf          # PostgreSQL 主配置
├── data/                        # 数据持久化目录
│   └── pgdata/                  # PostgreSQL 数据目录
├── init-scripts/                # 初始化脚本
│   └── 01-install-extensions.sql # 扩展安装脚本
├── logs/                        # 日志目录
└── test-examples.sql            # 测试示例

快速开始

1. 环境准备

确保系统已安装：

  • Docker
  • Docker Compose

2. 克隆或创建项目目录

mkdir -p ~/Server/PgSQL
cd ~/Server/PgSQL

3. 配置环境变量

创建 .env 文件：

# PostgreSQL 数据库配置
POSTGRES_DB=devdb
POSTGRES_USER=postgres
POSTGRES_PASSWORD=your_secure_password
POSTGRES_PORT=5432

# 注意：请修改 POSTGRES_PASSWORD 为您的实际密码
# 建议使用强密码，包含大小写字母、数字和特殊字符

4. 构建镜像

docker build -t postgres-all-extensions:latest .

5. 启动服务

docker-compose up -d

6. 验证安装

# 检查容器状态
docker ps

# 连接数据库验证扩展
docker exec postgres-all-extensions psql -U postgres -d devdb -c "SELECT extname, extversion FROM pg_extension WHERE extname IN ('timescaledb', 'postgis', 'vector') ORDER BY extname;"

详细配置说明

Dockerfile 解析

FROM postgres:15

# 安装系统依赖
RUN apt-get update && apt-get install -y \
    build-essential \
    postgresql-server-dev-15 \
    cmake \
    git \
    wget \
    ca-certificates \
    postgresql-15-postgis-3 \
    postgresql-15-postgis-3-scripts \
    libkrb5-dev \
    libgssapi-krb5-2 \
    && rm -rf /var/lib/apt/lists/*

# 安装 pgvector (预编译版本，避免段错误)
RUN cd /tmp && \
    wget https://github.com/pgvector/pgvector/archive/v0.5.1.tar.gz && \
    tar -xzf v0.5.1.tar.gz && \
    cd pgvector-0.5.1 && \
    make && \
    make install

# 安装 TimescaleDB (从源码编译)
RUN cd /tmp && \
    git clone https://github.com/timescale/timescaledb.git && \
    cd timescaledb && \
    git checkout 2.13.0 && \
    ./bootstrap && \
    cd build && \
    make && \
    make install

# 配置 PostgreSQL
RUN echo "shared_preload_libraries = 'timescaledb'" >> /usr/share/postgresql/postgresql.conf.sample

# 复制初始化脚本
COPY init-scripts/ /docker-entrypoint-initdb.d/

EXPOSE 5432

Docker Compose 配置

version: '3.8'

services:
  postgres-all-extensions:
    image: postgres-all-extensions:latest
    container_name: postgres-all-extensions
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - "5432:5432"
    volumes:
      - ./data/pgdata:/var/lib/postgresql/data
      - ./config/postgresql.conf:/etc/postgresql/postgresql.conf
      - ./config/pg_hba.conf:/etc/postgresql/pg_hba.conf
      - ./logs:/var/log/postgresql
    networks:
      - postgres-network
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 30s
      timeout: 10s
      retries: 3

networks:
  postgres-network:
    driver: bridge

扩展功能测试

PostGIS 测试

-- 创建几何数据
SELECT ST_AsText(ST_MakePoint(-71.064544, 42.28787));

-- 空间查询示例
CREATE TABLE locations (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100),
    geom GEOMETRY(POINT, 4326)
);

INSERT INTO locations (name, geom) VALUES
('Boston', ST_SetSRID(ST_MakePoint(-71.0589, 42.3601), 4326));

pgvector 测试

-- 创建向量表
CREATE TABLE items (
    id SERIAL PRIMARY KEY,
    embedding VECTOR(3)
);

-- 插入向量数据
INSERT INTO items (embedding) VALUES
('[1,2,3]'),
('[4,5,6]');

-- 向量相似度查询
SELECT * FROM items ORDER BY embedding <-> '[3,1,2]' LIMIT 5;

TimescaleDB 测试

-- 创建时序表
CREATE TABLE sensor_data (
    time TIMESTAMPTZ NOT NULL,
    sensor_id INTEGER,
    temperature DOUBLE PRECISION,
    humidity DOUBLE PRECISION
);

-- 转换为超表
SELECT create_hypertable('sensor_data', 'time');

-- 插入时序数据
INSERT INTO sensor_data VALUES
(NOW(), 1, 23.5, 65.2),
(NOW() - INTERVAL '1 hour', 1, 22.8, 64.1);

连接配置

IDE 连接参数

Host: localhost
Port: 5432
Database: devdb (或 postgres)
Username: postgres
Password: [您在.env中设置的密码]

命令行连接

# 使用 Docker 容器内的 psql
docker exec -it postgres-all-extensions psql -U postgres -d devdb

# 使用外部 psql (需要安装 PostgreSQL 客户端)
PGPASSWORD=your_password psql -h localhost -p 5432 -U postgres -d devdb

管理命令

启动/停止服务

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 查看日志
docker-compose logs -f

数据备份与恢复

# 备份数据库
docker exec postgres-all-extensions pg_dump -U postgres devdb > backup.sql

# 恢复数据库
docker exec -i postgres-all-extensions psql -U postgres devdb < backup.sql

性能监控

# 查看容器资源使用
docker stats postgres-all-extensions

# 查看数据库连接
docker exec postgres-all-extensions psql -U postgres -c "SELECT * FROM pg_stat_activity;"

安全建议

  1. 修改默认密码：确保在 .env 文件中设置强密码
  2. 网络安全：生产环境中限制 pg_hba.conf 的访问范围
  3. 数据加密：考虑启用 SSL/TLS 连接
  4. 定期备份：建立自动化备份策略
  5. 更新维护：定期更新 PostgreSQL 和扩展版本

版本信息

  • PostgreSQL: 15.14
  • PostGIS: 3.6.0
  • pgvector: 0.5.1
  • TimescaleDB: 2.13.0

许可证

本项目遵循 MIT 许可证。各个扩展遵循其各自的许可证条款。

]]>Docker Hue 时区修改完整指南https://blog.heyaohua.com/posts/2025/09/docker-hue-timezone/Mon, 08 Sep 2025 10:00:00 +0800https://blog.heyaohua.com/posts/2025/09/docker-hue-timezone/使用Docker启动Hue后，发现时区不正确，显示UTC时间而不是中国标准时间(CST)。具体表现为： - HDFS文件时间显示为UTC时间（如06:00-06:01） - 实际文件创建时间为中国时间（如14:00-14:01） - Hue日志时间格式混乱问题描述

使用Docker启动Hue后，发现时区不正确，显示UTC时间而不是中国标准时间(CST)。具体表现为：

  • HDFS文件时间显示为UTC时间（如06:00-06:01）
  • 实际文件创建时间为中国时间（如14:00-14:01）
  • Hue日志时间格式混乱

解决方案概述

需要从多个层面修改时区设置：

  1. 容器系统时区设置
  2. Hue配置文件时区设置
  3. Django时区设置
  4. 文件浏览器模块时区处理

详细修改步骤

1. 检查当前容器状态

# 查看运行中的Hue容器
docker ps -a | grep hue

# 检查容器时区
docker exec <container_name> date

# 检查Hue日志时间格式
docker logs <container_name> --tail 10

2. 备份原始配置

# 备份Hue配置文件
cp /data/server/hue-server/config/hue.ini /data/server/hue-server/config/hue.ini.backup.$(date +%Y%m%d_%H%M%S)
cp /data/server/hue-server/config/z-hue-overrides.ini /data/server/hue-server/config/z-hue-overrides.ini.backup.$(date +%Y%m%d_%H%M%S)

3. 修改Hue配置文件中的时区设置

3.1 修改主配置文件

# 修改 hue.ini 中的时区设置
sed -i 's/time_zone=America\/Los_Angeles/time_zone=Asia\/Shanghai/g' /data/server/hue-server/config/hue.ini

# 添加Django时区设置
sed -i '/time_zone=Asia\/Shanghai/a use_tz=true' /data/server/hue-server/config/hue.ini

3.2 修改覆盖配置文件

# 修改 z-hue-overrides.ini 中的时区设置
sed -i 's/time_zone=America\/Los_Angeles/time_zone=Asia\/Shanghai/g' /data/server/hue-server/config/z-hue-overrides.ini

4. 重新创建容器（包含时区和DNS设置）

4.1 停止并删除旧容器

docker stop <old_container_name>
docker rm <old_container_name>

4.2 创建新容器

docker run -d --name hue_new \
  -p 8888:8888 \
  -e TZ=Asia/Shanghai \
  -v /etc/localtime:/etc/localtime:ro \
  -v /usr/share/zoneinfo/Asia/Shanghai:/etc/timezone:ro \
  -v /data/server/hue-server/config:/usr/share/hue/desktop/conf \
  --dns=100.100.2.136 \
  --dns=8.8.8.8 \
  gethue/hue:latest

5. 修改文件浏览器模块时区处理

5.1 备份原始文件

docker exec hue_new cp /usr/share/hue/apps/filebrowser/src/filebrowser/views.py /usr/share/hue/apps/filebrowser/src/filebrowser/views.py.backup

5.2 修改时区处理代码

# 添加Django时区导入
docker exec hue_new sed -i "s/from datetime import datetime/from datetime import datetime, timezone, timedelta\nfrom django.utils import timezone as django_timezone/g" /usr/share/hue/apps/filebrowser/src/filebrowser/views.py

# 修改时间格式化代码
docker exec hue_new sed -i "s/datetime.fromtimestamp(stats.mtime).strftime('%B %d, %Y %I:%M %p')/django_timezone.make_aware(datetime.fromtimestamp(stats.mtime)).strftime('%B %d, %Y %I:%M %p')/g" /usr/share/hue/apps/filebrowser/src/filebrowser/views.py

5.3 清除Python缓存

docker exec hue_new find /usr/share/hue -name "*.pyc" -path "*/filebrowser/*" -delete
docker exec hue_new find /usr/share/hue -name "__pycache__" -path "*/filebrowser/*" -exec rm -rf {} \; 2>/dev/null || true

6. 重启容器应用修改

docker restart hue_new

7. 验证修改结果

7.1 检查系统时区

# 检查容器系统时间
docker exec hue_new date

# 检查时区环境变量
docker exec hue_new env | grep TZ

# 检查时区文件
docker exec hue_new cat /etc/timezone

7.2 检查Hue应用时区

# 查看Hue日志，确认时间格式
docker logs hue_new --tail 10

# 检查Django时区设置
docker exec hue_new /usr/share/hue/build/env/bin/python3 -c "import os; os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'desktop.settings'); import django; django.setup(); from django.utils import timezone; print('Django timezone:', timezone.get_current_timezone())"

7.3 检查文件浏览器时间显示

访问Hue文件浏览器，查看HDFS文件的时间显示是否正确。

关键配置说明

1. 环境变量设置

  • TZ=Asia/Shanghai: 设置容器系统时区
  • -v /etc/localtime:/etc/localtime:ro: 挂载主机时区文件
  • -v /usr/share/zoneinfo/Asia/Shanghai:/etc/timezone:ro: 挂载时区信息文件

2. DNS设置

  • --dns=100.100.2.136: 内网DNS服务器
  • --dns=8.8.8.8: 公共DNS服务器

3. 配置文件修改

  • hue.ini: 主配置文件中的 time_zone=Asia/Shanghai 和 use_tz=true
  • z-hue-overrides.ini: 覆盖配置文件中的 time_zone=Asia/Shanghai

4. 代码修改

  • 文件：/usr/share/hue/apps/filebrowser/src/filebrowser/views.py
  • 修改：使用Django的时区设置处理文件时间显示

完整的一键脚本

#!/bin/bash
# Hue时区修改完整脚本

CONTAINER_NAME="hue_new"
CONFIG_PATH="/data/server/hue-server/config"

echo "开始修改Hue时区设置..."

# 1. 备份配置
echo "备份原始配置..."
cp $CONFIG_PATH/hue.ini $CONFIG_PATH/hue.ini.backup.$(date +%Y%m%d_%H%M%S)
cp $CONFIG_PATH/z-hue-overrides.ini $CONFIG_PATH/z-hue-overrides.ini.backup.$(date +%Y%m%d_%H%M%S)

# 2. 修改配置文件
echo "修改时区配置..."
sed -i 's/time_zone=America\/Los_Angeles/time_zone=Asia\/Shanghai/g' $CONFIG_PATH/hue.ini
sed -i 's/time_zone=America\/Los_Angeles/time_zone=Asia\/Shanghai/g' $CONFIG_PATH/z-hue-overrides.ini
sed -i '/time_zone=Asia\/Shanghai/a use_tz=true' $CONFIG_PATH/hue.ini

# 3. 停止旧容器
echo "停止旧容器..."
docker stop $CONTAINER_NAME 2>/dev/null || true
docker rm $CONTAINER_NAME 2>/dev/null || true

# 4. 创建新容器
echo "创建新容器..."
docker run -d --name $CONTAINER_NAME \
  -p 8888:8888 \
  -e TZ=Asia/Shanghai \
  -v /etc/localtime:/etc/localtime:ro \
  -v /usr/share/zoneinfo/Asia/Shanghai:/etc/timezone:ro \
  -v $CONFIG_PATH:/usr/share/hue/desktop/conf \
  --dns=100.100.2.136 \
  --dns=8.8.8.8 \
  gethue/hue:latest

# 5. 等待启动
echo "等待容器启动..."
sleep 20

# 6. 修改文件浏览器代码
echo "修改文件浏览器时区处理..."
docker exec $CONTAINER_NAME cp /usr/share/hue/apps/filebrowser/src/filebrowser/views.py /usr/share/hue/apps/filebrowser/src/filebrowser/views.py.backup
docker exec $CONTAINER_NAME sed -i "s/from datetime import datetime/from datetime import datetime, timezone, timedelta\nfrom django.utils import timezone as django_timezone/g" /usr/share/hue/apps/filebrowser/src/filebrowser/views.py
docker exec $CONTAINER_NAME sed -i "s/datetime.fromtimestamp(stats.mtime).strftime('%B %d, %Y %I:%M %p')/django_timezone.make_aware(datetime.fromtimestamp(stats.mtime)).strftime('%B %d, %Y %I:%M %p')/g" /usr/share/hue/apps/filebrowser/src/filebrowser/views.py

# 7. 清除缓存
echo "清除Python缓存..."
docker exec $CONTAINER_NAME find /usr/share/hue -name "*.pyc" -path "*/filebrowser/*" -delete
docker exec $CONTAINER_NAME find /usr/share/hue -name "__pycache__" -path "*/filebrowser/*" -exec rm -rf {} \; 2>/dev/null || true

# 8. 重启容器
echo "重启容器应用修改..."
docker restart $CONTAINER_NAME

# 9. 等待重启
echo "等待容器重启..."
sleep 25

# 10. 验证结果
echo "验证时区设置..."
echo "系统时间:"
docker exec $CONTAINER_NAME date
echo ""
echo "Hue日志时间格式:"
docker logs $CONTAINER_NAME --tail 3
echo ""
echo "Django时区设置:"
docker exec $CONTAINER_NAME /usr/share/hue/build/env/bin/python3 -c "import os; os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'desktop.settings'); import django; django.setup(); from django.utils import timezone; print('Django timezone:', timezone.get_current_timezone())"

echo "时区修改完成！"
echo "请访问 http://localhost:8888 查看文件浏览器中的时间显示是否正确。"

常见问题排查

1. DNS解析问题

如果出现 Name or service not known 错误：

# 检查DNS配置
docker inspect <container_name> | grep -A 5 -B 5 -i dns

# 确保容器有正确的DNS设置
--dns=100.100.2.136 --dns=8.8.8.8

2. 时区仍然不正确

检查所有配置文件中的时区设置：

grep -r -i "time_zone\|timezone" /data/server/hue-server/config/ | grep -v ".backup"

3. 文件浏览器时间显示不正确

检查代码修改是否正确：

docker exec <container_name> grep -n -A 2 -B 2 "mtime.*datetime" /usr/share/hue/apps/filebrowser/src/filebrowser/views.py

4. 容器无法启动

检查挂载路径是否正确：

# 确保配置文件路径存在
ls -la /data/server/hue-server/config/

# 检查挂载权限
ls -la /data/server/hue-server/config/hue.ini

验证成功标志

  • 容器系统时间显示：Mon Sep 8 15:08:02 Asia 2025
  • Hue日志时间格式：[08/Sep/2025 15:08:02 +0800]
  • 环境变量：TZ=Asia/Shanghai
  • Django时区：Asia/Shanghai
  • HDFS文件时间显示：正确的中国时间（如14:00-14:01）
  • HDFS连接正常，无DNS解析错误

注意事项

  1. 备份重要: 修改前务必备份原始配置文件和代码文件
  2. DNS设置: 确保容器有正确的DNS配置，否则无法连接HDFS
  3. 配置文件: 需要修改两个配置文件：hue.ini 和 z-hue-overrides.ini
  4. 代码修改: 需要修改文件浏览器模块的时区处理代码
  5. 重启生效: 修改配置和代码后需要重启容器才能生效
  6. 权限检查: 确保挂载的配置文件有正确的读写权限
  7. 缓存清理: 修改Python代码后需要清除缓存

回滚方法

如果修改后出现问题，可以按以下步骤回滚：

# 1. 恢复配置文件
cp /data/server/hue-server/config/hue.ini.backup.* /data/server/hue-server/config/hue.ini
cp /data/server/hue-server/config/z-hue-overrides.ini.backup.* /data/server/hue-server/config/z-hue-overrides.ini

# 2. 恢复代码文件
docker exec <container_name> cp /usr/share/hue/apps/filebrowser/src/filebrowser/views.py.backup /usr/share/hue/apps/filebrowser/src/filebrowser/views.py

# 3. 重启容器
docker restart <container_name>
]]>Redis Docker开发环境配置指南https://blog.heyaohua.com/posts/2024/03/redis-docker-development-guide/Tue, 19 Mar 2024 12:00:00 +0800https://blog.heyaohua.com/posts/2024/03/redis-docker-development-guide/本文档详细介绍如何使用Docker搭建Redis开发环境，包括环境配置、启动方式、维护方法等内容。Redis Docker开发环境配置指南

本文档详细介绍如何使用Docker搭建Redis开发环境，包括环境配置、启动方式、维护方法等内容。

目录结构

Redis_Docker/
├── .env                # 环境变量配置文件
├── README.md          # 项目说明文档
├── config/            # 配置文件目录
│   └── redis.conf    # Redis配置文件
├── data/             # 数据存储目录
└── logs/             # 日志文件目录

配置文件说明

1. docker-compose.yml

version: '3.8'

services:
  redis:
    container_name: redis-server
    image: redis:7.2
    ports:
      - "${REDIS_PORT}:6379"
    volumes:
      - ./data:/data
      - ./logs:/var/log/redis
      - ./config/redis.conf:/usr/local/etc/redis/redis.conf
    command: redis-server /usr/local/etc/redis/redis.conf
    environment:
      - TZ=Asia/Shanghai
    networks:
      - redis-network
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 5s

networks:
  redis-network:
    driver: bridge

2. .env 环境变量配置

# Redis 配置环境变量
REDIS_PORT=6379           # Redis端口映射
REDIS_PASSWORD=your_password  # Redis访问密码

3. redis.conf 主要配置

# 网络设置
bind 0.0.0.0
port 6379
protected-mode yes
tcp-keepalive 300

# 基本设置
databases 16
loglevel notice
logfile "/var/log/redis/redis.log"

# 内存设置
maxmemory 256mb
maxmemory-policy allkeys-lru
maxmemory-samples 5

# 持久化设置
save 900 1      # 900秒内至少1个键被修改
save 300 10     # 300秒内至少10个键被修改
save 60 10000   # 60秒内至少10000个键被修改

# AOF设置
appendonly yes
appendfilename "appendonly.aof"
appendfsync everysec

使用说明

1. 启动服务

# 启动服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs redis

2. 连接Redis

# 使用容器内的redis-cli
docker-compose exec redis redis-cli -a your_password

# 使用主机的redis-cli（如果已安装）
redis-cli -h localhost -p 6379 -a your_password

# 测试连接
redis-cli -h localhost -p 6379 -a your_password ping

3. 停止服务

# 停止服务
docker-compose down

数据持久化

Redis配置了双重持久化机制：

1. RDB持久化

  • 文件位置：data/dump.rdb
  • 自动保存策略：
  • 900秒内至少1个键被修改
  • 300秒内至少10个键被修改
  • 60秒内至少10000个键被修改

2. AOF持久化

  • 文件位置：data/appendonly.aof
  • 同步策略：everysec（每秒同步）
  • 重写策略：auto-aof-rewrite-percentage 100

性能优化

1. 内存配置

  • maxmemory：设置为256MB
  • maxmemory-policy：使用allkeys-lru策略
  • maxmemory-samples：设置为5

2. 网络优化

  • tcp-keepalive：300秒
  • tcp-backlog：511

3. 持久化优化

  • appendfsync：everysec
  • no-appendfsync-on-rewrite：no

安全配置

1. 网络安全

  • protected-mode：启用
  • bind：0.0.0.0（允许所有IP访问）
  • requirepass：设置访问密码

2. 客户端限制

  • maxclients：10000
  • timeout：0（不自动断开空闲连接）

监控和维护

1. 性能监控

# 查看服务器信息
redis-cli -a your_password INFO

# 监控命令执行
redis-cli -a your_password MONITOR

# 查看慢查询日志
redis-cli -a your_password SLOWLOG GET

2. 内存分析

# 查看内存使用情况
redis-cli -a your_password INFO memory

# 查看大键
redis-cli -a your_password --bigkeys

3. 数据备份

# 手动触发RDB备份
redis-cli -a your_password SAVE

# 异步触发RDB备份
redis-cli -a your_password BGSAVE

常见问题处理

1. 连接失败

  • 检查密码是否正确
  • 确认端口映射是否正确
  • 验证Redis服务是否正常运行

2. 内存问题

  • 检查maxmemory设置
  • 查看内存使用情况
  • 考虑调整内存策略

3. 持久化问题

  • 检查磁盘空间
  • 查看AOF/RDB文件状态
  • 确认写入权限

最佳实践

1. 安全建议

  • 使用强密码
  • 限制可访问的IP
  • 定期更新Redis版本

2. 性能建议

  • 合理设置内存上限
  • 选择适当的持久化策略
  • 监控慢查询

3. 运维建议

  • 定期备份数据
  • 监控系统资源
  • 保持日志分析
]]>PostgreSQL Docker开发环境配置指南https://blog.heyaohua.com/posts/2024/03/postgresql-docker-development-guide/Tue, 19 Mar 2024 11:30:00 +0800https://blog.heyaohua.com/posts/2024/03/postgresql-docker-development-guide/本文档详细介绍如何使用Docker搭建PostgreSQL开发环境，包括环境配置、启动方式、维护方法等内容。PostgreSQL Docker开发环境配置指南

本文档详细介绍如何使用Docker搭建PostgreSQL开发环境，包括环境配置、启动方式、维护方法等内容。

目录结构

PgSQL_Docker/
├── .env                  # 环境变量配置文件
├── README.md            # 项目说明文档
├── config/              # 配置文件目录
│   ├── pg_hba.conf     # 访问控制配置
│   └── postgresql.conf  # PostgreSQL主配置文件
├── data/               # 数据存储目录
└── logs/               # 日志文件目录

配置文件说明

1. docker-compose.yml

version: '3.8'

services:
  postgres:
    container_name: postgres-server
    image: postgres:15
    environment:
      - POSTGRES_DB=${POSTGRES_DB}
      - POSTGRES_USER=${POSTGRES_USER}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    ports:
      - "${POSTGRES_PORT}:5432"
    volumes:
      - ./data:/var/lib/postgresql/data
      - ./logs:/var/log/postgresql
      - ./config/postgresql.conf:/etc/postgresql/postgresql.conf
      - ./config/pg_hba.conf:/etc/postgresql/pg_hba.conf
    command: postgres -c 'config_file=/etc/postgresql/postgresql.conf'
    networks:
      - postgres-network
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s

networks:
  postgres-network:
    driver: bridge

2. .env 环境变量配置

# PostgreSQL 配置环境变量
POSTGRES_DB=test_db           # 数据库名称
POSTGRES_USER=data           # 默认超级用户
POSTGRES_PASSWORD=your_password  # 用户密码
POSTGRES_PORT=5432          # 端口映射

3. postgresql.conf 主要配置

# 连接设置
listen_addresses = '*'
port = 5432
max_connections = 100

# 内存设置
shared_buffers = 128MB
work_mem = 4MB
maintenance_work_mem = 64MB
effective_cache_size = 512MB

# 写入设置
wal_level = replica
max_wal_size = 1GB
min_wal_size = 80MB

# 日志设置
log_destination = 'stderr'
logging_collector = on
log_directory = '/var/log/postgresql'
log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
log_rotation_age = 1d
log_rotation_size = 10MB

# 区域设置
datestyle = 'iso, mdy'
timezone = 'UTC'
lc_messages = 'en_US.utf8'

4. pg_hba.conf 访问控制配置

# TYPE  DATABASE        USER            ADDRESS                 METHOD
local   all            all                                     trust
host    all            all             127.0.0.1/32           scram-sha-256
host    all            all             ::1/128                scram-sha-256
host    all            all             0.0.0.0/0              scram-sha-256

使用说明

1. 启动服务

# 启动服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs postgres

2. 连接数据库

# 使用超级用户连接
docker-compose exec postgres psql -U data -d test_db

# 查看用户列表和权限
\du

# 查看数据库列表
\l

# 退出psql
\q

3. 停止服务

# 停止服务
docker-compose down

用户和权限管理

PostgreSQL使用角色（Role）概念来管理用户权限。在我们的配置中：

  1. 通过POSTGRES_USER环境变量创建的用户（本例中为"data"）是超级用户，具有所有权限：
  2. Superuser（超级用户权限）
  3. Create role（创建角色权限）
  4. Create DB（创建数据库权限）
  5. Replication（复制权限）

Bypass RLS（绕过行级安全性）

创建新用户示例：

CREATE ROLE username WITH LOGIN PASSWORD 'password';
  1. 授予权限示例：
GRANT ALL PRIVILEGES ON DATABASE dbname TO username;

数据备份和恢复

备份数据

# 备份整个数据库
docker-compose exec postgres pg_dump -U data test_db > backup.sql

# 备份特定表
docker-compose exec postgres pg_dump -U data -t table_name test_db > table_backup.sql

恢复数据

# 恢复数据
docker-compose exec -T postgres psql -U data test_db < backup.sql

性能优化建议

  1. 内存配置
  2. shared_buffers: 建议设置为系统内存的25%
  3. effective_cache_size: 建议设置为系统内存的50%

work_mem: 根据并发连接数调整

写入性能

  1. wal_buffers: 建议设置为16MB
  2. checkpoint_timeout: 可根据写入压力调整

max_wal_size: 根据磁盘空间调整

连接池

  1. 建议使用pgBouncer等连接池管理工具
  2. 避免频繁创建新连接

常见问题处理

  1. 容器无法启动
  2. 检查端口占用：lsof -i :5432
  3. 检查配置文件权限

查看错误日志：docker-compose logs postgres

连接失败

  1. 确认用户名和密码正确
  2. 检查pg_hba.conf配置

验证网络连接

性能问题

  1. 检查慢查询日志
  2. 使用EXPLAIN分析查询计划
  3. 优化索引和查询语句

安全建议

  1. 密码安全
  2. 使用强密码
  3. 定期更换密码

避免在命令行中明文输入密码

网络安全

  1. 限制访问IP
  2. 使用SSL连接

定期更新PostgreSQL版本

权限控制

  1. 遵循最小权限原则
  2. 使用角色管理权限
  3. 启用行级安全性（RLS）

维护建议

  1. 定期维护
  2. 执行VACUUM操作
  3. 更新统计信息

检查日志文件大小

监控

  1. 监控连接数
  2. 监控磁盘使用

监控查询性能

备份策略

  1. 定期备份
  2. 测试恢复流程
]]>MySQL Docker开发环境配置指南https://blog.heyaohua.com/posts/2024/03/mysql-docker-development-guide/Tue, 19 Mar 2024 11:00:00 +0800https://blog.heyaohua.com/posts/2024/03/mysql-docker-development-guide/重要配置说明： - - 容器异常退出时自动重启 - - 环境变量配置，支持从.env文件读取 - - 数据持久化配置，确保数据安全 - - 端口映射，允 …如何使用Docker启动MySQL开发环境

目录结构

MySQL_Docker/
├── docker-compose.yml    # Docker Compose 配置文件
├── .env                 # 环境变量配置
├── config/
│   └── my.cnf          # MySQL 配置文件
├── data/               # MySQL 数据目录 (挂载)
└── logs/               # MySQL 日志目录 (挂载)

配置文件说明

1. docker-compose.yml 配置要点

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    container_name: mysql-server
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-root123}
      MYSQL_DATABASE: ${MYSQL_DATABASE:-testdb}
      MYSQL_USER: ${MYSQL_USER:-testuser}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD:-testpass}
    ports:
      - "${MYSQL_PORT:-3306}:3306"
    volumes:
      - ./data:/var/lib/mysql
      - ./logs:/var/log/mysql
      - ./config/my.cnf:/etc/mysql/conf.d/my.cnf

重要配置说明：

  • restart: unless-stopped - 容器异常退出时自动重启
  • environment - 环境变量配置，支持从.env文件读取
  • volumes - 数据持久化配置，确保数据安全
  • ports - 端口映射，允许外部访问

2. MySQL配置文件 (my.cnf) 要点

[mysqld]
# 基本设置
port = 3306
bind-address = 0.0.0.0
default-storage-engine = InnoDB

# 字符集设置（重要）
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

# 连接设置
max_connections = 200
max_connect_errors = 10

# 缓冲区设置
innodb_buffer_pool_size = 256M
innodb_log_file_size = 64M
innodb_log_buffer_size = 16M

# 日志设置
log-error = /var/log/mysql/error.log
slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 2

配置注意事项：

  1. 字符集必须设置为utf8mb4，以支持完整的Unicode字符集
  2. 根据服务器内存调整缓冲区大小
  3. 开启慢查询日志便于性能优化
  4. MySQL 8.0已不支持查询缓存（query_cache）相关配置

3. 环境变量配置 (.env)

MYSQL_ROOT_PASSWORD=your_root_password
MYSQL_DATABASE=your_database
MYSQL_USER=your_user
MYSQL_PASSWORD=your_password
MYSQL_PORT=3306

安全注意事项：

  • 生产环境必须修改默认密码
  • .env文件不要提交到版本控制系统
  • 定期更换密码
  • 避免使用弱密码

启动和维护

启动服务

docker-compose up -d

查看服务状态

docker-compose ps

查看日志

# 查看容器日志
docker-compose logs mysql

# 查看错误日志
tail -f logs/error.log

# 查看慢查询日志
tail -f logs/slow.log

停止服务

docker-compose down

常见问题处理

1. 容器无法启动或反复重启

  • 检查数据目录权限
  • 查看错误日志（logs/error.log）
  • 确认配置文件语法正确
  • 验证端口是否被占用

2. 连接失败

  • 确认容器运行状态
  • 检查端口映射
  • 验证用户名密码
  • 检查防火墙设置

3. 性能问题

  • 检查慢查询日志
  • 调整缓冲区大小
  • 优化索引
  • 监控资源使用情况

数据备份建议

1. 使用docker-compose执行备份

docker-compose exec mysql mysqldump -u root -p database_name > backup.sql

2. 自动备份脚本示例

#!/bin/bash
backup_dir="backups"
date_format=$(date +%Y%m%d_%H%M%S)
docker-compose exec -T mysql mysqldump -u root -p database_name > "${backup_dir}/backup_${date_format}.sql"

安全建议

  1. 网络安全
  2. 限制端口访问
  3. 使用专用网络

启用SSL/TLS加密

账户安全

  1. 定期更换密码
  2. 限制用户权限

删除未使用的账户

数据安全

  1. 定期备份
  2. 加密敏感数据
  3. 监控异常访问

性能优化建议

  1. 硬件资源
  2. 适当分配内存
  3. 使用SSD存储

监控CPU使用率

配置优化

  1. 调整缓冲池大小
  2. 优化日志设置

配置合适的连接数

查询优化

  1. 建立合适的索引
  2. 优化SQL语句
  3. 定期维护统计信息
]]>