Docker 部署 Typecho 博客系统（新版） 🐳

Typecho Banner

📋 目录导航

🎯 项目简介

Typecho 是一款轻量级的开源博客系统，基于 PHP 开发，具有高效、稳定、易用的特点。
结合 Docker 部署，您可以在任何支持 Docker 的平台（Linux、Windows、macOS、NAS 等）上快速部署和运行 Typecho，实现数据持久化和灵活配置。

🛠️ 核心特性

特性类别 功能描述 优势
⚡ 轻量高效 核心程序仅约 500KB 资源占用低，响应速度快
📝 Markdown 支持 原生支持 Markdown 写作 简洁高效的写作体验
🎨 主题系统 丰富的主题生态系统 轻松定制博客外观
🔌 插件扩展 功能丰富的插件市场 灵活扩展博客功能
📊 多数据库支持 支持 SQLite、MySQL、PostgreSQL 部署灵活，适应不同环境
🌐 多语言支持 内置多语言界面 国际化支持良好
🔧 简洁后台 直观易用的管理界面 操作简单，上手快速
📱 响应式设计 自适应各种设备屏幕 在手机和平板上体验良好
🔒 安全可靠 严格的代码安全规范 保障博客数据安全
📂 标准兼容 支持 XML-RPC 接口 方便与其他系统集成

🐳 一、Docker 部署 Typecho 博客系统

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
mkdir -p /mnt/mydisk/home/typecho && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  typecho:
    image: joyqi/typecho:nightly-php8.2-apache
    container_name: typecho
    restart: always
    ports:
      - "8383:80"
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./typecho/usr:/app/usr
      - ./typecho/config.inc.php:/app/config.inc.php
    depends_on:
      - db

  db:
    image: mariadb:10.6
    container_name: typecho-db
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=typecho
      - MYSQL_USER=typecho
      - MYSQL_PASSWORD=typecho_password
      - TZ=Asia/Shanghai
    volumes:
      - ./db:/var/lib/mysql
EOF

🔐 数据库密码：请将 root_password 和 typecho_password 替换为您自己的强密码！

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Typecho

1. 访问 Web 界面 💻

2. 首次使用步骤 🎯

  1. 打开浏览器访问上述地址
  2. 按照安装向导完成 Typecho 的初始配置
  3. 设置数据库连接信息（使用 compose 中配置的数据库信息）
  4. 创建管理员账户
  5. 开始撰写您的第一篇博客文章！

🌐 三、Nginx 反向代理配置

访问地址示例：https://typecho.example.com:666

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/typecho.conf <<'EOF'
server {
    listen 666 ssl;
    listen [::]:666 ssl;
    server_name typecho.example.com;   # 🌐 替换为你的域名

    # SSL 证书
    ssl_certificate /etc/nginx/keyfile/cert.pem;
    ssl_certificate_key /etc/nginx/keyfile/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_ciphers ECDHE+AESGCM:ECDHE+CHACHA20:!aNULL:!MD5;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件大小限制
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:8383;
        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_buffering off;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 错误页
    error_page 404 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🚀 五 、安装主题和插件

1. 安装前台主题

1. 安装 butterfly 前台主题

1
2
3
4
5
6
sudo chmod -R 755 /vol1/1000/compose/typecho/typecho && \
cd /vol1/1000/compose/typecho/typecho/usr/themes && \
wget -c https://github.com/wehaox/Typecho-Butterfly/releases/download/1.8.1/butterfly_Release1.8.1.zip && \
unzip butterfly_Release1.8.1.zip && \
rm butterfly_Release1.8.1.zip && \
chmod -R 755 butterfly

2. Typecho 后台启用主题 ⚙️

    1. 登录 Typecho 后台
    1. 进入”控制台” → “外观”
    1. 选择新安装的主题并点击”启用”

2. 安装后台主题 ✨

1. 安装 butterfly 前台主题

3. 安装插件

1
2
## 插件目录加读写权限
sudo chmod -R 755 /vol1/1000/compose/typecho/typecho/usr/plugins

🌟 启航博客，书写无限

通过本文档，您已经成功使用 Docker 部署了 Typecho 博客系统，并借助 Nginx 反向代理实现了安全便捷的访问。现在，您可以：

✍️ 自由表达 在轻量高效的平台上书写您的所思所想，记录生活点滴
🎨 个性定制 通过丰富的主题和插件系统，打造独一无二的博客空间
🌍 连接世界 将您的观点和创意分享给全球读者，建立个人品牌
🔐 完全自主 所有数据掌握在自己手中，享受真正的数字自主权

博客是思想的容器，是创意的舞台，更是连接志同道合者的桥梁。愿 Typecho 成为您可靠的数字笔友，陪伴您在每一个灵感激荡的时刻，记录每一个值得珍藏的瞬间。

从现在开始，执笔为剑，书写传奇——构建您独具特色的网络家园吧！✨

📌 持续优化：建议关注 Typecho 官方更新，及时获取新功能与安全补丁
🐛 交流互助：使用中如有疑问或建议，可前往 GitHub Issues 参与讨论

祝您写作愉快，博客有成！🎉