Linux 服务部署手册

1. 概述

1.1 部署方案

嘟哩私有化部署基于 Docker 构建，每个服务都会打包为独立镜像。

在线部署时，可通过一行命令自动下载依赖并完成安装。

离线部署时，可先下载镜像包后再按客户环境配置并初始化数据。

1.2 部署方式

名称	描述
本地部署	客户自行购买服务器，并架设到企业自己的机房中。
云部署	客户在云计算服务提供方购买服务器。

1.3 部署架构

名称	描述	用户规模（参考值）	服务器数量
单节点部署	一般部署到一台物理服务器上	0-200 人	1 台
分离式部署	内外网分离：消息服务、云盘服务、邮箱服务分开部署	100-999 人	3 台

2. 环境准备

2.1 服务器配置

2.1.1 体验版配置

用户数	CPU	内存	硬盘
100 人以内	4 核	12G	60GB

2.1.2 正式版配置

用户数	CPU	内存	硬盘
0-200	24 核+	64G+	1TB+

2.2 操作系统及软件

名称	版本	备注
操作系统	CentOS 7.9	建议使用纯净操作系统，否则可能导致端口无法正常启动，安装脚本异常结束。

2.3 网络环境及要求

名称	端口	备注
代理端口/项目端口/服务端口	`3306`、`9001-9018`、`10001-10002`、`8085/18085`、`12321-12322`、`19001-19018`	1. 本机防火墙需放行以上端口。 2. 如需手机等设备外网访问，请按 TCP 进行端口映射。 3. 使用云服务器时，请同时放行安全组规则。 4. `-` 表示端口范围，`/` 表示并列端口。 5. `19001-19018` 仅用于内网访问时可不开放公网。

3. 安装部署

采用 Docker 方式安装部署。Linux 下执行一键部署命令，预计 12 分钟完成。

3.1 Docker 安装

嘟哩安装脚本会自动安装 Docker。若对 Docker 版本有特殊要求，可自行按 Docker 官方文档安装。

3.2 服务安装

准备工作完成后，先检查基础环境。部署方式分为在线部署与离线部署。

名称	描述	备注
在线部署方式	通过脚本从外网下载服务端安装包，并在脚本内自动配置与部署。	1. 外网可达。 2. Yum 源可用。 3. 无端口冲突。

3.2.1 检查安装环境

bash

# 系统检查
cat /etc/redhat-release

# 内存检查
free -m

# CPU 检查
cat /proc/cpuinfo | awk '/processor/' | wc -l

# 硬盘检查
df -h

3.2.2 单节点部署

一行命令自动下载依赖并完成安装：

bash

cd /opt/ && echo yes | /bin/bash -c "$(curl -fsSL https://ops.duliduli.com/Linux/download/Single_Node_Deployment/v1.0.1/install.sh )"

开始初始化系统参数：

开始部署单节点所需服务与项目：

脚本安装过程中会自动下载服务端安装包：

安装包下载后，脚本会安装 Docker 并分配 Docker 虚拟 IP，然后连接镜像仓库：

Docker 安装完成后会拉取服务容器（镜像较大，请耐心等待）：

相关镜像拉取完成后，会优先启动服务镜像并初始化 MySQL 数据库：

随后继续拉取服务端镜像：

安装完成后终端会输出嘟哩相关地址：

查看容器（docker ps）：

登录管理后台后，按流程申请授权并激活服务。

3.2.3 卸载重装

bash

# 删除 Docker 容器资源。
# 若存在嘟哩容器外的容器，请手动甄别，避免误删。
# 注意：重装命令会清理历史嘟哩数据，请确认后执行。
docker stop $(docker ps | egrep -i duli | awk '{print $NF}')
docker rm -f $(docker ps -aq)
docker rmi -f $(docker images | egrep -i duli | awk '{print $3}')
docker network ls | egrep compose | awk '{print $1}' | xargs docker network rm
rm -rf /opt/dldl-installer-*
rm -f ~/quick-install.sh
clear
cd /opt/ && echo yes | /bin/bash -c "$(curl -fsSL https://ops.duliduli.com/Linux/download/Single_Node_Deployment/v1.0.1/install.sh )"

3.3 版本更新

3.3.1 单节点更新

bash

# 进入脚本根目录
cd /opt/dldl-installer-v1.0.1

# 执行更新命令
sh quick-install.sh update

脚本会自动获取官方版本号并提示，输入目标版本后回车即可自动更新。

更新后可看到版本已升级到目标版本（示例：v1.0.2）。

3.4 服务与镜像

安装完成后会有以下服务：

容器名	容器镜像	说明
DuliApache	192.168.168.241/duliimages/duliapache	代理服务
DuliMysql	192.168.168.241/duliimages/dulimysql	数据库
DuliRedis	192.168.168.241/duliimages/duliredis	缓存服务
DuliHBase	192.168.168.241/duliimages/dulihbase	消息数据库
DuliGoFast	192.168.168.241/duliimages/duligofast	文件服务
Duli	192.168.168.241/duliimages/duli	入口、消息、后台、认证服务
DuliWpp	192.168.168.241/duliimages/duliwpp	云盘服务
DuliMail	192.168.168.241/duliimages/dulimail	邮箱服务
DuliService	192.168.168.241/duliimages/duliservice	客服服务
DuliMgmt	192.168.168.241/duliimages/dulimgmt	工作流服务
DuliYjs	192.168.168.241/duliimages/duliyjs	文档协同服务

镜像版本可能与示例不同。

3.4.1 服务管理

bash

docker [start|stop|restart] 容器名

3.4.2 服务日志

bash

docker logs -f 容器名

类型	服务名称	标识名	当天日志	历史日志
安装脚本	安装脚本	安装脚本	`/var/log/duliduli/duliduli.log`	-
嘟哩项目	网盘服务	`DuliWpp`	`logs/DuliWpp/DuliWpp.out`	`logs/DuliWpp/DuliWpp.out-20240715.gz`
嘟哩项目	邮箱服务	`DuliMail`	`logs/DuliMail/DuliMail.out`	`logs/DuliMail/DuliMail.out-20240715.gz`
嘟哩项目	工作流服务	`DuliMgmt`	`logs/DuliMgmt/DuliMgmt.out`	`logs/DuliMgmt/DuliMgmt.out-20240715.gz`
嘟哩项目	客服服务	`DuliService`	`logs/DuliService/DuliService.out`	`logs/DuliService/DuliService.out-20240715.gz`
嘟哩项目	消息服务	`DuliFront`	`logs/DuliFront/DuliFront.out`	`logs/DuliFront/DuliFront.out-20240715.gz`
嘟哩项目	后台服务	`DuliBackend`	`logs/DuliBackend/DuliBackend.out`	`logs/DuliBackend/DuliBackend.out-20240715.gz`
嘟哩项目	入口服务	`DuliRoute`	`logs/DuliRoute/DuliRoute.log`	`logs/DuliRoute/7z/2024-07/2024-07-13-1.DuliRoute.gz`
嘟哩项目	认证服务	`DuliAuth`	`logs/DuliAuth/DuliAuth.out`	`logs/DuliAuth/DuliAuth.out-20240715.gz`
服务	代理服务	`DuliApache`	`logs/DuliApache/access.log`	`logs/DuliApache/log/access.log-20240714.gz` 等
服务	数据库	`DuliMysql`	`logs/DuliMysql/logs/mysqld.log`	-
服务	消息数据库	`DuliHBase`	`logs/DuliHBase/hbase-root-master-hbase-server.log`	-
服务	文件服务	`DuliGoFast`	`logs/DuliGoFast/log/fileserver.log`	-

3.4.3 端口信息

类型	服务端	服务/项目	代理端口	项目端口
嘟哩代理	代理服务	DuliApache	80/443	80/443
嘟哩数据库	数据库	DuliMysql	3306	3306
嘟哩数据库	缓存服务	DuliRedis	7001-7006	7001-7006
嘟哩数据库	消息数据库	DuliZookeeper	2181	2181
嘟哩数据库	消息数据库	DuliHadoop	50010	50010
嘟哩数据库	消息数据库	DuliHBase	16010	16010
嘟哩文件服务	文件服务	DuliGoFast	19001	9001
嘟哩	入口服务	DuliRoute	19002	9002
嘟哩	消息服务	DuliFront	19003	9003
嘟哩	后台服务	DuliBackend	19005	9005
嘟哩	认证服务	DuliAuth	19006	9006
嘟哩	DuliRoute Socket	streamPort Socket	29002	9002
嘟哩	DuliFront Socket	wsPort Socket	19009	9009
嘟哩	DuliFront Socket	nettyPort Socket	19010	9010
嘟哩	DuliFront Socket	androidPort Socket	19011	9011
嘟哩	DuliFront Socket	natcrossPort WsSocket	19012	9012
嘟哩	DuliFront Socket	natcrossTransferPort WsSocket	19015	9015
嘟哩网盘	云盘服务	ClooudDisk	19014	9014
嘟哩网盘	云盘服务	Disk Socket	29014	9014
嘟哩网盘	云盘服务	uploadPort	19004	9004
嘟哩在线协作	文档协同服务	yjs	12234	2234
嘟哩邮箱	邮箱服务	DuliMail	19017	9017
嘟哩客服	客服服务	DuliService	19007	9007
嘟哩客服	DuliService Client	DuliService Client	19008	9008
嘟哩工作流	工作流服务	DuliMgmt	19018	9018
嘟哩在线预览	在线预览服务	openoffice	18085	8085

3.5 数据维护

所有服务数据映射在本机 /app 目录（安装目录内）下。

目录	说明
`/opt/dldl-installer-v1.0.1`	服务安装根路径
`quick-install.sh`	服务端管理主脚本
`soft`	服务端安装压缩包
`scripts`	子脚本
`conf`	地址、端口、数据库配置参数
`compose`	项目、服务 compose 启动文件
`log`	项目、服务日志存放目录
`data`	项目、服务数据存放目录
`data/DuliDataBackup`	HBase、Hadoop 备份路径
`data/DuliApache/cert`	SSL 证书路径

3.5.1 HBase 维护

bash

docker exec -it DuliHBase sh -c "hbase shell"

示例：查看 HBase 表

bash

docker exec -it DuliHBase sh -c "echo 'list' | hbase shell"

数据备份脚本：

bash

# 快照备份 1 天数据
docker exec -it DuliHBase sh -c 'sh /opt/hbase_backup.sh SnapExport 1'

# 物理备份 1 天数据
docker exec -it DuliHBase sh -c 'sh /opt/hbase_backup.sh Export 1'

3.5.2 MySQL 维护

bash

docker exec -ti DuliMysql sh -c 'mysql -h${MysqlAddress} -uroot -P${MysqlPort}'

手动备份：

bash

docker exec -ti DuliMysql sh -c 'mysqldump -uroot -h"$MysqlAddress" -P"$MysqlPort" --all-databases -ER' > /路径/备份文件

脚本备份：

bash

# 进入嘟哩安装目录
cd /opt/dldl-installer-v1.0.1

# 加载环境变量
. quick-install.sh

# 执行备份脚本
sh scripts/mysql.sh Export

4. 域名配置

4.1 HTTPS 协议变更

4.1.1 环境准备

域名（单个）	证书文件	私钥文件
一级/二级域名	CRT 或 PEM 格式	KEY 格式

示例配置：

域名	证书文件	私钥文件
`example.com`	`cert.crt`	`cert.key`

4.1.2 SSL 配置修改

修改协议前请先备份相关文件，避免配置失误导致服务不可用。

进入安装目录：

bash

cd /opt/dldl-installer-v1.0.1

上传证书：

bash

# 可使用 sftp 上传证书，或使用 rz 命令
# 安装 rz：
yum install -y lrzsz

# 拷贝证书到 nginx 的 cert 目录
cp cert.crt cert.key data/DuliApache/cert/

执行 HTTPS 启用脚本：

bash

sh scripts/enable_nginx_https.sh

选择启用 HTTPS（输入 1）：

输入准备好的域名：

5. 开始体验

5.1 访问管理后台

text

https://example.com:9005/html/login.html

5.2 授权激活

嘟哩官网注册并完成企业认证后，可获取免费版 License 文件。

购买企业版或 VIP 版后，按机器码获取 License 文件并导入。

导入 License 需联网校验，请确保可访问 duliduli.com 域名。

6. 客户端下载

嘟哩支持 Mac、Windows、iOS、Android 四大平台客户端。

可从官网下载安装包（Android 与 iOS 建议从应用商店搜索“嘟哩”安装）。

复制 嘟哩管理地址.txt 中的 IP 与端口（如配置域名外网访问则填写域名与端口），并配置到客户端。

同意协议后点击登录（账号可在管理后台创建；若已对接短信服务，也可在客户端自行注册）。

登录完成后即可使用嘟哩。

7. 常用命令

7.1 容器与镜像查看

bash

docker ps
docker images

7.2 容器启停

bash

docker start ImagesName
# 或
sh quick-install.sh start ImagesName

bash

docker stop ImagesName
# 或
sh quick-install.sh stop ImagesName

bash

docker restart ImagesName
# 或
sh quick-install.sh restart ImagesName

7.3 重载服务配置

bash

. quick-install.sh
docker-compose -f compose/docker-compose-service.yml create ServerName
# 或
sh quick-install.sh create ImagesName

7.4 配置变更示例

bash

# 1. 进入安装根目录
cd /opt/dldl-installer-v1.0.1

# 2. 获取环境变量
. quick-install.sh

# 3. 编辑 compose 文件
vim compose/docker-compose-service.yml

# 4. 添加配置参数
# 例如：为代理服务增加 9004:9004 端口映射

# 5. 重载代理服务配置
docker-compose -f compose/docker-compose-service.yml create DuliApache
# 或
sh quick-install.sh create DuliApache

# 6. 重启该服务
docker restart DuliApache
# 或
sh quick-install.sh restart DuliApache

7.5 进入常用服务

进入 HBase：

bash

. quick-install.sh
docker exec -it DuliHBase sh -c "hbase shell"

进入 Redis：

bash

. quick-install.sh
docker exec -it DuliRedis sh -c "redis-cli -h \"$RedisAddress\" -a \"$REDIS_PASSWORD\" -p 7001"

Linux 服务部署手册 ​

1. 概述 ​

1.1 部署方案 ​

1.2 部署方式 ​

1.3 部署架构 ​

2. 环境准备 ​

2.1 服务器配置 ​

2.1.1 体验版配置 ​

2.1.2 正式版配置 ​

2.2 操作系统及软件 ​

2.3 网络环境及要求 ​

3. 安装部署 ​

3.1 Docker 安装 ​

3.2 服务安装 ​

3.2.1 检查安装环境 ​

3.2.2 单节点部署 ​

3.2.3 卸载重装 ​

3.3 版本更新 ​

3.3.1 单节点更新 ​

3.4 服务与镜像 ​

3.4.1 服务管理 ​

3.4.2 服务日志 ​

3.4.3 端口信息 ​

3.5 数据维护 ​

3.5.1 HBase 维护 ​

3.5.2 MySQL 维护 ​

4. 域名配置 ​

4.1 HTTPS 协议变更 ​

4.1.1 环境准备 ​

4.1.2 SSL 配置修改 ​

5. 开始体验 ​

5.1 访问管理后台 ​

5.2 授权激活 ​

6. 客户端下载 ​

7. 常用命令 ​

7.1 容器与镜像查看 ​

7.2 容器启停 ​

7.3 重载服务配置 ​

7.4 配置变更示例 ​

7.5 进入常用服务 ​

Linux 服务部署手册

1. 概述

1.1 部署方案

1.2 部署方式

1.3 部署架构

2. 环境准备

2.1 服务器配置

2.1.1 体验版配置

2.1.2 正式版配置

2.2 操作系统及软件

2.3 网络环境及要求

3. 安装部署

3.1 Docker 安装

3.2 服务安装

3.2.1 检查安装环境

3.2.2 单节点部署

3.2.3 卸载重装

3.3 版本更新

3.3.1 单节点更新

3.4 服务与镜像

3.4.1 服务管理

3.4.2 服务日志

3.4.3 端口信息

3.5 数据维护

3.5.1 HBase 维护

3.5.2 MySQL 维护

4. 域名配置

4.1 HTTPS 协议变更

4.1.1 环境准备

4.1.2 SSL 配置修改

5. 开始体验

5.1 访问管理后台

5.2 授权激活

6. 客户端下载

7. 常用命令

7.1 容器与镜像查看

7.2 容器启停

7.3 重载服务配置

7.4 配置变更示例

7.5 进入常用服务