Docker新手必看：5分钟搞定XWiki知识库部署（含国内镜像加速配置）

Docker新手必看：5分钟搞定XWiki知识库部署（含国内镜像加速配置）

你是否刚接触Docker，看着满屏的命令行感到无从下手，却又急需一个功能强大的知识库来整理团队文档？或者，你曾尝试部署一些开源应用，却因为网络问题，在“拉取镜像”这一步就卡了半小时，最终无奈放弃？今天，我们就来彻底解决这个问题。XWiki，作为一个成熟的企业级开源Wiki和知识管理平台，功能强大但部署并不复杂。关键在于，如何绕过国内网络环境的“天然屏障”，让整个安装过程如丝般顺滑。这篇文章就是为你准备的——一位技术新手也能看懂的、保姆级的实战指南。我们不只告诉你命令是什么，更会解释为什么这么做，以及当命令不奏效时，你该如何思考和排查。从配置Docker国内镜像加速，到用docker-compose一键拉起包含数据库和应用的完整服务，再到部署后首次访问的配置与常见“坑点”的规避，我们将一步步拆解。目标很简单：让你在喝杯咖啡的时间里，拥有一个完全在自己掌控下的、可随时访问的XWiki知识库。

1. 部署前的环境准备与核心概念扫盲

在直接动手敲命令之前，花几分钟理解几个核心概念，能让你在后续的步骤中不仅知其然，更知其所以然，甚至在遇到问题时也能从容应对。Docker的本质是一种容器化技术，你可以把它想象成一个超级轻量级的虚拟机。它把应用程序及其所有依赖项（库、环境变量、配置文件等）打包成一个标准化的“镜像”。当你运行这个镜像时，就创建了一个“容器”——一个独立、隔离的进程空间。这种方式的巨大优势在于环境一致性：你在自己电脑上测试通过的镜像，可以百分百确信在生产服务器上也能以完全相同的方式运行。

对于XWiki这样的复杂应用，它通常需要两个核心服务：应用服务器（如Tomcat，用于运行XWiki的Java程序）和数据库（如PostgreSQL，用于存储所有Wiki页面、用户数据等）。在传统部署中，你需要分别安装、配置并连接这两者，步骤繁琐。而Docker的解决方案，特别是docker-compose工具，允许我们用一个简单的YAML配置文件，同时定义并启动这多个相互关联的容器，并自动处理好它们之间的网络连接。这就是我们实现“一键部署”的基石。

提示：如果你尚未安装Docker和Docker Compose，请先访问Docker官网获取对应你操作系统（Windows/macOS/Linux）的安装包。Linux用户通常可以通过包管理器（如apt或yum）安装，但建议使用官方脚本以获得最新版本。

接下来，我们将直面新手在国内部署时的第一个，也是最大的拦路虎：镜像下载速度。

1.1 配置国内Docker镜像加速器

默认情况下，Docker会从位于国外的Docker Hub官方仓库拉取镜像。这对国内用户来说，速度往往慢如蜗牛，甚至频繁超时失败。解决方案是配置一个“镜像加速器”，它相当于一个位于国内的缓存代理，会定期从Docker Hub同步热门镜像。当你的Docker客户端请求镜像时，它会从国内的加速器节点快速获取，体验提升立竿见影。

配置方法主要是修改Docker守护进程的配置文件。以下以Linux系统为例，Windows和macOS用户可以在Docker Desktop的设置界面中找到类似的“Registry mirrors”选项进行图形化配置。

首先，创建或编辑Docker的守护进程配置文件：

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://<你的镜像加速器地址>"
  ]
}
EOF

这里的关键是<你的镜像加速器地址>。国内常用的、稳定的加速器服务商包括：