OI Wiki 离线版 3 种部署方式从选型到排障的完全指南【免费下载链接】OI-wiki:star2: Wiki of OI / ICPC for everyone. 某大型游戏线上攻略内含炫酷算术魔法项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki地铁里信号断了你急着查一道动态规划的状态转移本地装好的 OI Wiki 才是救命稻草。这篇文章讲清 Docker、本地源码构建、gh-pages 静态页面三种部署 OI Wiki 离线版的常见方式外加日常更新与高频问题。读完你手里就有一份断网也能查的竞赛百科。三种方案怎么选OI Wiki 离线版选型速览方案上手难度耗时首次适用人群可维护性Docker 容器低约 10 分钟取决于镜像下载速度新手、想在多系统统一环境的人高拉新镜像即可gh-pages 静态页面最低约 5 分钟临时查阅、一次性使用中git pull 即更新源码构建中20~40 分钟装依赖 构建想自定义构建选项的开发者中pull 后需重新构建三种方案的本质差别Docker 把环境烤进镜像里静态页面直接给你成品文件源码构建则是自己从源码编译。没想好就先照最快路径跑起来再回来挑长期方案。最快路径两条命令跑通 OI Wiki 离线版最快的是克隆项目的gh-pages分支——这个分支里放的是已经构建好的静态页面不用装 Python 环境也不用构建。git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki.git -b gh-pages cd OI-wiki python -m http.server 8000第一行把现成页面拉到本地第二行用 Python 自带模块起一个本地服务器。然后浏览器打开http://127.0.0.1:8000就能看。✅ 验证首页能打开、目录能正常翻页就行。比如排序章节里你就能看到下图这种合并步骤的图示到这里临时查资料的需求已经满足。想要长期使用往下看挑一个合适的方案。Docker 方案新手怎么装 OI Wiki 离线版适用人群不想碰 Python 环境和依赖只想装上就能用的人。Docker 把整套构建环境打包进镜像跨 Windows、macOS、Linux 表现一致所以新手优先选它。前提条件系统装好 Docker且当前用户有运行容器的权限root 或 docker 组成员即可。操作步骤# 三个镜像源按你的网络任选其一 docker pull 24oi/oi-wiki # Docker Hub 官方镜像 docker pull daocloud.io/sirius/oi-wiki # DaoCloud国内 docker pull ccr.ccs.tencentyun.com/oi-wiki/oi-wiki # Tencent Hub国内拉镜像相当于下载一个打包好的 wiki官方源慢就换两个国内源之一。docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki-d让容器在后台跑-p 8080:8000把容器里的 8000 端口映射到主机的 8080被占用就换个号--name oi-wiki给容器起名方便后面管理。验证方式浏览器打开http://127.0.0.1:8080能正常显示首页就成功了。之后想更新容器里的内容而不重建容器进容器执行两条命令即可docker exec -it oi-wiki /bin/bash # 进容器 wiki-upd # 更新 wiki 内容 wiki-bld # 重新构建静态页面更多参数细节可以看 Docker 部署官方文档。静态页面方案gh-pages 分支临时一用适用人群只想查这一阵子、不想装任何东西的人。它的本质是下载成品页面 起个本地服务器到此为止没有更多东西。前提条件系统里有 git 和 Python3http.server模块要用别的要求没有。操作步骤就是最快路径里那两条命令——克隆gh-pages分支再启动python -m http.server 8000不再重复。验证方式http://127.0.0.1:8000能打开页面即可。⚠️ 注意它的局限构建选项无法自定义内容更新取决于维护者往gh-pages分支推的版本分支落后时你看到的就是旧内容。源码构建方案想折腾的开发者选它适用人群需要自定义构建选项、或者打算直接参与项目、修改内容的人。产物是site目录下的静态页面之后想怎么部署都行。前提条件Python3Linux/macOS 一般预装Windows 用户去官网装外加uv包管理工具。操作步骤git clone https://gitcode.com/GitHub_Trending/oi/OI-wiki.git --depth1 cd OI-wiki--depth1只取最新快照省下载时间。pip install uv uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/先装 uv再同步项目依赖这里直接走清华源避免海外源超时。OI Wiki 用的是自定义主题还要单独装Linux/macOS 执行./scripts/pre-build/install-theme.shWindows 用户用 Git Bash 执行bash scripts/pre-build/install-theme.sh。uv run mkdocs build -v cd site python -m http.server 8000第一行把静态页面构建进site目录第二行起本地服务器预览。验证方式浏览器打开http://127.0.0.1:8000页面完整、样式正常构建就算成功。日常维护各方案怎么更新 OI Wiki 离线版wiki 内容会持续更新记得隔段时间刷一次本地。每个方案刷新的动作不一样方案更新命令说明Dockerdocker stop oi-wiki docker rm oi-wiki再docker pull 24oi/oi-wiki最后docker run -d -p 8080:8000 --name oi-wiki 24oi/oi-wiki用新镜像重建容器源码构建git pull后执行uv run mkdocs build -v拉代码再重新构建页面静态页面git pull只拉取不用构建Docker 场景里如果不想重建容器也可以进容器跑wiki-updwiki-bld只更新内容。排障速查依赖装不上、端口被占用怎么办症状可能原因解决命令uv sync依赖安装失败网络拉取源不畅换国内源uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple/服务器起了但页面打不开8000 端口被占用换端口python -m http.server 8080再访问127.0.0.1:8080docker 命令提示权限不足当前用户不在 docker 组sudo usermod -aG docker $USER注销后重新登录镜像拉取很慢海外镜像源国内访问差换 DaoCloud 或 Tencent Hub 镜像源见 Docker 方案一句话收尾按场景挑长期用选 Docker临时查用静态页面想折腾就源码构建。如果实操中卡住了或者发现文章里值得补充的新章节、想修个错字欢迎到项目官方仓库提 issue 或提交贡献——OI Wiki 是靠大家一起维护起来的。【免费下载链接】OI-wiki:star2: Wiki of OI / ICPC for everyone. 某大型游戏线上攻略内含炫酷算术魔法项目地址: https://gitcode.com/GitHub_Trending/oi/OI-wiki创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考