导语:Confluence是目前主流的小团队在线文档、知识库协作工具,以往部署大多卡在MySQL驱动下载、配置繁琐问题。本文选用PostgreSQL数据库,官方内置驱动,无需下载任何Jar包,一条命令完成整套部署,个人、小团队均可落地。
一、部署前置条件(配图:服务器硬件/端口放行截图)
操作系统:CentOS、Ubuntu、Debian全Linux通用 硬件配置:服务器内存≥4G(Confluence占用内存较高) 预装软件:Docker + Docker Compose 安全设置:防火墙放行8090端口,外网可正常访问
二、部署实操三步法(配图:SSH终端输入命令截图)
步骤1:创建部署目录
SSH连接服务器,执行命令新建专属存放目录
mkdir -p /opt/confluence && cd /opt/confluence
步骤2:生成docker-compose配置文件
复制下方整段命令,一键生成编排配置
cat > docker-compose.yml <<EOF
version: "3.8"
services:
postgres:
image: postgres:14-alpine
container_name: confluence-pg
restart: always
environment:
POSTGRES_DB: confluence
POSTGRES_USER: confuser
POSTGRES_PASSWORD: ConfPass123
TZ: Asia/Shanghai
volumes:
- ./pg-data:/var/lib/postgresql/data
networks:
- conf-net
confluence:
image: atlassian/confluence-server:7.20.3-jdk17
container_name: confluence
restart: always
depends_on:
- postgres
environment:
TZ: Asia/Shanghai
CATALINA_OPTS: -Duser.timezone=Asia/Shanghai -Xms2G -Xmx2G
ports:
- "8090:8090"
volumes:
- ./confluence-data:/var/atlassian/application-data/confluence
- /etc/localtime:/etc/localtime:ro
networks:
- conf-net
networks:
conf-net:
driver: bridge
EOF
步骤3:后台启动服务
# 后台拉起容器
docker compose up -d
# 实时查看启动日志
docker logs -f confluence
⏰ 小提示:首次初始化需要2~3分钟,出现
Confluence has been started successfully即启动成功。
三、浏览器初始化配置(配图:Confluence初始化向导页面、数据库填写页面)
打开浏览器访问:http://服务器公网IP:8090,跟着向导配置:
选择语言,安装类型勾选【产品安装】; 数据库关键配置(直接照抄)|配置项|填写内容| | ---- | ---- | |数据库类型|PostgreSQL| |主机地址|postgres| |端口|5432| |数据库名|confluence| |用户名|confuser| |密码|ConfPass123| 点击【测试连接】,提示连接成功后下一步; 保存页面生成的Server ID,后续用于许可证配置; 设置管理员账号密码,完成站点初始化。
四、知识库基础使用(配图:新建空间、文档编辑界面)
新建空间:按照项目/业务分类创建专属空间,用来归类各类文档; 权限管控:按需设置匿名浏览、成员编辑权限,适配内部/对外文档; 文档编辑:在线编写富文本文档,支持图片、附件、表格、代码块插入,实现多人在线协同编辑。
五、日常运维常用命令(配图:终端运维命令示例)
# 停止整套服务
docker compose down
# 单独重启Confluence
docker compose restart confluence
# 数据库备份(导出SQL备份文件)
docker exec confluence-pg pg_dump -U confuser confluence > confluence_$(date +%Y%m%d).sql
六、优化实用小贴士
✅ 数据安全:confluence-data、pg-data两个目录持久化存储所有数据,删除容器不会丢失文档; ✅ 性能优化:服务器内存≥8G,修改JVM参数 -Xms3G -Xmx4G,提升打开与检索速度; ✅ 域名访问:备案域名后,可配置Nginx反向代理,绑定域名+HTTPS访问知识库。
夜雨聆风