lufeidot/typecho

Typecho Docker镜像文档

镜像概述

Typecho Docker镜像是基于官方Typecho开源博客系统构建的容器化部署方案。Typecho是一款轻量级、高性能的开源博客系统，基于PHP开发，以简洁的架构、低资源占用和丰富的扩展性著称。该镜像旨在简化Typecho的部署流程，提供一致、隔离的运行环境，帮助用户快速搭建个人博客或小型内容站点。

核心功能与特性

轻量级架构

• 基于PHP环境构建，整体资源占用低，适合低配服务器或个人主机
• 精简的代码结构，页面加载速度快，提升用户访问体验

多数据库支持

• 原生支持MySQL、SQLite等主流数据库，适配不同使用场景
• 可通过环境变量灵活配置数据库连接参数，满足多样化部署需求

丰富的扩展性

• 支持自定义主题（Theme）和插件（Plugin），可通过挂载目录持久化保存
• 兼容Typecho官方主题和插件生态，轻松扩展功能

容器化优势

• 开箱即用，无需手动配置PHP环境、Web服务器（内置Nginx/PHP-FPM）
• 环境隔离，避免与宿主机其他服务冲突，简化版本管理和升级流程
• 跨平台兼容，支持Linux、macOS、Windows等主流操作系统的Docker环境

使用场景与适用范围

个人博客搭建

• 适合个人用户快速部署专属博客，记录生活、分享技术或兴趣内容
• 支持Markdown编辑、文章管理、评论系统等核心博客功能

小型内容站点

• 可用于构建产品介绍页、个人作品集、团队博客等小型内容平台
• 轻量级特性确保在低配置服务器上稳定运行

开发与测试环境

• 为开发者提供一致的Typecho运行环境，便于主题/插件开发测试
• 支持快速重置环境，提高开发效率

学习与实践

• 适合学习PHP Web开发、Docker容器化部署、Web服务器配置等技术

使用方法与配置说明

基本使用（Docker Run）

1. 快速启动（SQLite模式，无需额外数据库）

若无需复杂数据库配置，可直接使用SQLite作为数据存储（适合个人博客或测试场景）：

bash
docker run -d \
  --name typecho \
  -p 80:80 \
  -v /path/to/typecho/data:/usr/src/typecho \
  typecho

• -p 80:80：将容器内80端口映射到宿主机80端口，通过http://宿主机IP访问
• -v /path/to/typecho/data:/usr/src/typecho：挂载宿主机目录到容器内，持久化保存配置、主题、插件、文章数据等
• 首次启动后，访问http://宿主机IP进入Typecho安装向导，按提示完成初始化（数据库类型选择SQLite）

2. MySQL模式（生产环境推荐）

若需使用MySQL数据库（支持多用户、数据备份更灵活），需先部署MySQL服务（可使用Docker容器或外部MySQL）：

步骤1：启动MySQL容器（示例）

bash
docker run -d \
  --name typecho-mysql \
  -e MYSQL_ROOT_PASSWORD=your_mysql_password \
  -e MYSQL_DATABASE=typecho \
  -e MYSQL_USER=typecho_user \
  -e MYSQL_PASSWORD=typecho_password \
  -v /path/to/mysql/data:/var/lib/mysql \
  mysql:5.7

步骤2：启动Typecho容器（连接MySQL）

bash
docker run -d \
  --name typecho \
  -p 80:80 \
  --link typecho-mysql:mysql \  # 连接MySQL容器（若MySQL在外部，替换为实际IP）
  -v /path/to/typecho/data:/usr/src/typecho \
  -e TYPECHO_DB_HOST=mysql \  # 数据库主机（容器名或IP）
  -e TYPECHO_DB_USER=typecho_user \  # 数据库用户名
  -e TYPECHO_DB_PASSWORD=typecho_password \  # 数据库密码
  -e TYPECHO_DB_NAME=typecho \  # 数据库名
  -e TYPECHO_DB_TYPE=mysql \  # 数据库类型（mysql/sqlite）
  -e TZ=Asia/Shanghai \  # 设置时区（避免时间显示异常）
  typecho

使用Docker Compose部署

对于多容器管理（如Typecho+MySQL），推荐使用docker-compose.yml简化配置：

yaml
version: '3'

services:
  typecho:
    image: typecho
    container_name: typecho
    ports:
      - "80:80"
    volumes:
      - ./typecho_data:/usr/src/typecho  # 持久化Typecho数据
    environment:
      - TYPECHO_DB_HOST=mysql
      - TYPECHO_DB_USER=typecho_user
      - TYPECHO_DB_PASSWORD=typecho_password
      - TYPECHO_DB_NAME=typecho
      - TYPECHO_DB_TYPE=mysql
      - TZ=Asia/Shanghai
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: mysql:5.7
    container_name: typecho-mysql
    volumes:
      - ./mysql_data:/var/lib/mysql  # 持久化MySQL数据
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=typecho
      - MYSQL_USER=typecho_user
      - MYSQL_PASSWORD=typecho_password
    restart: unless-stopped

启动命令：

bash
docker-compose up -d

环境变量配置

通过环境变量可自定义Typecho运行参数，常用变量说明如下：

持久化数据

为避免容器重建导致数据丢失，需挂载以下关键目录：

• 宿主机目录：/path/to/typecho/data（自定义路径）
• 容器内目录：/usr/src/typecho（Typecho主目录，包含配置文件、主题、插件、上传文件等）

挂载后，以下数据将持久化保存：

• config.inc.php：系统配置文件
• usr/themes/：主题目录
• usr/plugins/：插件目录
• usr/uploads/：上传文件（图片、附件等）
• SQLite数据库文件（若使用SQLite模式）

注意事项

1. 首次安装向导
   容器启动后，需通过浏览器访问http://宿主机IP进入Typecho安装向导，完成数据库配置、管理员账号设置等步骤。

2. 数据库权限
   使用MySQL时，确保数据库用户拥有足够权限（如CREATE、ALTER、INSERT等），建议提前创建专用数据库和用户。

3. 版本升级
   升级Typecho版本时，建议先备份持久化目录数据，再拉取最新镜像重启容器，避免配置文件冲突。

4. 安全配置

   • 生产环境中建议修改默认管理员密码，启用HTTPS（可通过Nginx反向代理实现）
   • 限制数据库访问来源，避免直接暴露容器端口到公网

5. 性能优化
   若站点访问量较大，可通过配置Nginx缓存静态资源（主题CSS/JS、图片等），或升级服务器配置改善性能。