Docker deploy
本页面将介绍使用 Docker 部署 OI Wiki 环境的方式．
Warning
以下步骤须在 root 用户下或 docker 组用户下执行．
拉取 OI Wiki 镜像
---|---
## 自行构建镜像
---|---
- （必须）设置
[name]以设置镜像名，（可选）设置[tag]以设置镜像标签（若设置，则运行时镜像名由两部分构成）． - 可以通过
--build-arg参数设置环境变量．
可以使用的环境变量：
- 可以设置
WIKI_REPO来使用 Wiki 仓库的镜像站点（当未设置时自动使用 GitHub） - 可以设置
PYPI_MIRROR来使用 PyPI 仓库的镜像站点（当未设置时自动使用官方 PyPI） - 在国内建议使用 TUNA 镜像站
https://pypi.tuna.tsinghua.edu.cn/simple/ - 可以设置
LISTEN_IP来更改监听 IP（当未设置时为0.0.0.0，即监听所有 IP 的访问） - 可以设置
LISTEN_PORT来更改监听端口（当未设置时为8000）
示例：
---|---
## 运行容器
---|---
- （必须）设置
[image]以设置镜像．例如，从 Docker Hub 拉取的为24oi/oi-wiki；DaoCloud Hub 拉取的则为daocloud.io/sirius/oi-wiki． - （必须）设置
-p [port]:8000以映射容器端口至主机端口（不写该语句则默认为不暴露端口．设置时请替换[port]为主机端口）．设置后可以在主机使用http://127.0.0.1:[port]访问 OI Wiki ． - 设置
--name [name]以设置容器名字．（默认空．设置时请替换[name]为自定义的容器名字．若想查看容器 id，则输入docker ps）
使用容器
Note
示例基于 Ubuntu latest 部署．
进入容器：
---|---
若在上述运行容器中去掉 `-d`，则可以直接进入容器 bash，退出后容器停止，加上 `-d` 则后台运行，请手动停止．上述进入容器针对加上 `-d` 的方法运行．
特殊用法：
---|---
退出容器：
---|---
## 停止容器
---|---
启动容器
---|---
## 重启容器
---|---
删除容器
---|---
## 更新镜像
重新再 `pull` 一次即可，通常不会更新．
## 删除镜像
---|---
疑问
如果您有疑问，欢迎提出 issue！
本页面最近更新： 2026/1/7 08:56:54，更新历史 发现错误？想一起完善？在 GitHub 上编辑此页！ 本页面贡献者：frank-xjh, Junyan721113, billchenchina, c-forrest, ChungZH, CoelacanthusHex, dong628, Enter-tainer, Ir1d, ksyx, Menci, mxr612, NachtgeistW, Tiphereth-A 本页面的全部内容在CC BY-SA 4.0 和 SATA 协议之条款下提供，附加条款亦可能应用