OI Wiki 离线版怎么部署：3 条路线选 1 条就够
【免费下载链接】OI-wiki:star2: Wiki of OI / ICPC for everyone. （某大型游戏线上攻略，内含炫酷算术魔法）项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki
机房断网、出差飞机上，想查算法资料却没网，这种时候本地有一份 OI Wiki 离线版就能直接打开浏览器读。本文按"你怎么用"来对比 3 条离线部署路线，帮你 30 秒选好一条，选完最多 5 分钟就能跑起来。
先选路：3 条离线路线对比 🧭
| 对比维度 | 静态页面 | Docker 容器 | 源码构建 |
|---|---|---|---|
| 适合谁 | 纯阅读、偶尔用 | 长期挂着当资源站 | 要改内容、参与建设 |
| 上手成本 | 2 条命令 | 3 条命令 + 装 Docker | 5 条以上命令 + 同步依赖 |
| 要装什么 | 只需 Python | Docker | Python 3 + uv |
一句话判断：需要改内容才选源码构建，否则越轻越好。
最快上手：2 条命令拉下 OI Wiki 静态页面 ⚡
OI Wiki 无网使用、临时应急这种场景，这是成本最低的路线：gh-pages分支里放的就是构建好的站点，拉下来起个静态服务器就行，零依赖安装。
git clone -b gh-pages https://gitcode.com/GitHub_Trending/oi/OI-wiki cd OI-wiki && python -m http.server 8000第一条只取静态页面分支；第二条的意思是在仓库目录里用 Python 自带服务器起本地服务，浏览器打开http://127.0.0.1:8000即可。
页面里的配图、例题代码都预先烤进了静态文件，离线读不亏体验。日后更新内容，cd OI-wiki && git pull再刷新浏览器就行。
长期挂着用：Docker 一条命令跑起 OI Wiki 离线部署
如果打算把 OI Wiki 离线版长期开起来（比如当机房服务器的本地资源站），推荐 Docker 路线：官方镜像24oi/oi-wiki已带好完整环境，只需拉取加运行。
docker pull 24oi/oi-wiki docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki-d表示后台运行，-p 8080:8000把容器 8000 端口映射到本机 8080，--name给容器起名方便管理。跑完访问http://127.0.0.1:8080。国内网络拉不动官方源时，把 pull 换成 DaoCloud 或腾讯云镜像源即可，其余不变。
日常只记两条：docker stop oi-wiki停、docker start oi-wiki启。想让离线版内容跟上游同步，重建容器一次：
docker stop oi-wiki && docker rm oi-wiki docker pull 24oi/oi-wiki docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki改端口、换镜像源等更多容器参数，看官方文档 docs/intro/docker-deploy.md。
想改内容：面向开发者的源码构建
只有这条路线能让你直接改 Markdown、即时预览渲染效果，适合参与 OI Wiki 建设的开发者。前提是 Python 3（Linux/macOS 基本预装）和 uv 包管理工具：
git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki --depth=1 cd OI-wiki pip install uv uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/uv sync按仓库清单装构建依赖，--index-url指向清华镜像，国内基本不会卡。接着装自定义主题并构建：
./scripts/pre-build/install-theme.sh uv run mkdocs build -v cd site && python -m http.server 8000产物在site/目录，最后一条起本地服务器预览。改了页面就重跑中间的构建命令；以后同步上游，git pull加重新构建即可。
踩坑速查
- 8000/8080 端口被占用：换个端口。静态服务写
python -m http.server 8081，Docker 写-p 8081:8000。 docker pull超时：换国内镜像源，例如docker pull daocloud.io/sirius/oi-wiki。- docker 命令提示权限不足：
sudo usermod -aG docker $USER，注销重新登录。 uv sync装依赖失败：确认已走清华源；仍失败就检查代理或重试。
卡住了去哪问
容器完整参数列表、构建细节，官方文档 docs/intro/docker-deploy.md 都写得清楚；文档没覆盖的问题，直接到项目社区提问，维护者响应很快。
【免费下载链接】OI-wiki:star2: Wiki of OI / ICPC for everyone. （某大型游戏线上攻略，内含炫酷算术魔法）项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
