Typecho Icefox Bundle

一个可以直接部署的 Typecho 朋友圈风格站点包，内置 Typecho 1.3.0、Icefox 主题、Icefox 配套插件，以及两个可选增强插件：LinuxDoLogin 和 TelegramSync。

这个仓库基于 Typecho 和 xiaopanglian/icefox 整理而来，并保留了原 Icefox 主题/插件的作者信息和项目链接。当前版本把主题、插件和 Typecho 程序合并在一个仓库里，适合想快速搭建朋友圈样式 Typecho 站点的人直接使用。

包含内容

• admin/、var/、install.php、install/：Typecho 程序文件
• usr/themes/icefox/：Icefox 朋友圈风格主题
• usr/plugins/Icefox/：Icefox 主题必需插件，提供点赞、评论、置顶、友情链接等接口
• usr/plugins/LinuxDoLogin/：可选 Linux.do Connect 登录插件
• usr/plugins/TelegramSync/：可选 Telegram 频道/群组同步插件
• usr/themes/default/、usr/themes/classic-22/：随包保留的备用主题
• deploy.sh、deploy.env.example：可选的 rsync 部署脚本

已脱敏

公开版不包含个人站点配置、数据库账号密码、服务器 IP、SSH Key 路径、SQL 导出、压缩归档、用户上传文件、评论数据、用户账号、第三方 token 或 OAuth secret。

需要你自己填写的内容都使用了占位符，例如：

• config.example.inc.php 中的数据库连接信息
• deploy.env.example 中的服务器和 SSH 信息
• LinuxDoLogin 插件设置里的 Client Id、Client Secret
• TelegramSync 插件设置里的 Bot Token、Chat ID

安装

1. 把仓库放到网站根目录。

git clone https://github.com/yourname/typecho-icefox-bundle.git
cd typecho-icefox-bundle

2. 创建一个空数据库，并确保 PHP 已启用常用扩展：

• mysqli 或 pdo_mysql
• mbstring
• json
• curl

3. 打开安装向导：

https://example.com/install.php

按 Typecho 安装页面填写数据库、站点名和管理员账号。安装完成后会生成你自己的 config.inc.php。

也可以手动复制示例配置：

cp config.example.inc.php config.inc.php

然后把 database_user、database_password、database_name 等占位符改成你的真实数据库信息。

启用主题和插件

安装 Typecho 后进入后台：

1. 插件管理中启用 Icefox。这是 Icefox 主题必需插件。
2. 外观中启用 icefox 主题。
3. 进入主题设置，填写顶部图片、Logo、头像跳转、备案信息、Gravatar 加速地址等。
4. 如需 Linux.do 登录，启用 LinuxDoLogin 并填写 Linux.do Connect 应用信息。
5. 如需 Telegram 同步，启用 TelegramSync 并填写 Bot Token、频道或群组 Chat ID。

常用页面

Icefox 主题内置了几个页面模板：

• archive-page.php：归档页
• edit-page.php：前台发布/编辑页
• game-page.php：小游戏页面

在 Typecho 后台新建独立页面时选择对应模板，并把页面地址设置成你想要的路径，例如 /archive.html、/edit.html。

部署

如果你使用 VPS 或 1Panel，可以参考 DEPLOY.md：

cp deploy.env.example deploy.env
./deploy.sh --dry-run
./deploy.sh

deploy.env 不会被提交，usr/uploads/ 也默认不进入 Git。生产环境中的上传文件和数据库配置需要由你自己维护。

目录说明

typecho-icefox-bundle/
├── admin/                 Typecho 后台
├── install/               Typecho 安装程序资源
├── usr/
│   ├── plugins/
│   │   ├── Icefox/        Icefox 必需插件
│   │   ├── LinuxDoLogin/  可选登录插件
│   │   └── TelegramSync/  可选同步插件
│   ├── themes/
│   │   ├── icefox/        主主题
│   │   ├── default/       备用主题
│   │   └── classic-22/    备用主题
│   └── uploads/           运行时上传目录，仓库只保留空目录
├── var/                   Typecho 核心库
├── config.example.inc.php 数据库配置示例
├── deploy.env.example     部署配置示例
└── deploy.sh              可选部署脚本

致谢

• Typecho
• xiaopanglian/icefox
• Bulma、Alpine.js、Axios、Fancybox、ScrollLoad

许可证

本仓库是多个组件的整理包，请遵循各组件原始许可证和源码头部声明：

• Typecho 核心文件保留 GPL 2.0 声明，见 LICENSE.txt 和源码头部。
• Icefox 主题/插件保留原作者信息和原项目链接。
• 第三方前端库按其各自许可证分发。

如果你准备公开分发修改版，建议保留本 README 中的致谢与来源说明。