14.9K Star，一款好用的在线文档协作工具

欢迎大家来到IT世界,在知识的湖畔探索吧!

Etherpad在线文档协作编辑工具

一、前言

Etherpad是一种开源的实时协作编辑器，允许多个用户同时编辑同一文档，并实时显示每个用户的输入内容。Etherpad最初由Etherpad基金会开发，后来被Google收购，现在由Apache软件基金会维护。Etherpad可以用于协作编辑文档、记录会议纪要、编写代码等多种场景。现已开源

• 「项目地址：github地址:https://github.com/ether/etherpad-lite」
• 「登录页」

欢迎大家来到IT世界,在知识的湖畔探索吧!

• 「共享编辑」

• 「可以记录整个协同写作的过程」
• 在线聊天

二、安装部署

• 环境信息

名称版本备注Centoscentos7.9操作系统Node.jsv14.18.0Node.js

2.1 安装Node.js 环境

 #下载node-v14.18.0 [root@sre ~]# wget https://npm.taobao.org/mirrors/node/v14.18.0/node-v14.18.0-linux-x64.tar.xz #解压并重命名 [root@sre ~]# tar -xf node-v14.18.0-linux-x64.tar.xz -C /usr/local [root@sre ~]# mv /usr/local/node-v14.18.0-linux-x64 /usr/local/nodejs #设置环境变量 [root@sre ~]# vim /etc/profile #在最下面追加几行 #nodejs export PATH=/usr/local/nodejs/bin:$PATH #使环境变量生效 [root@sre ~]# source /etc/profile #通过这个命令进行测试 [root@sre ~]# node -v v14.18.0 [root@sre ~]# npm -v 6.14.15 #设置淘宝npm加速 [root@sre ~]# npm config set registry https://registry.npm.taobao.org #通过这个命令进行测试 [root@sre ~]# npm config get registry 

欢迎大家来到IT世界,在知识的湖畔探索吧!

2.2 安装Etherpad

欢迎大家来到IT世界,在知识的湖畔探索吧!#下载最新的包 [root@sre ~]# wget https://github.com/ether/etherpad-lite/archive/1.8.18.zip #重命名包并查看包内容 [root@sre ~]# mv etherpad-lite-1.8.18/ etherpad-lite [root@sre ~]# ll etherpad-lite 总用量 156 lrwxrwxrwx 1 root root 7 6月 8 10:43 bin -> src/bin -rw-r--r-- 1 root root 53690 5月 6 2022 CHANGELOG.md -rw-r--r-- 1 root root 8922 5月 6 2022 CONTRIBUTING.md drwxr-xr-x 6 root root 249 5月 6 2022 doc -rw-r--r-- 1 root root 3412 5月 6 2022 Dockerfile -rw-r--r-- 1 root root 11353 5月 6 2022 LICENSE -rw-r--r-- 1 root root 849 5月 6 2022 Makefile drwxr-xr-x 2 root root 30 5月 6 2022 node_modules -rw-r--r-- 1 root root 12525 5月 6 2022 README.md -rw-r--r-- 1 root root 118 5月 6 2022 SECURITY.md -rw-r--r-- 1 root root 21473 5月 6 2022 settings.json.docker -rw-r--r-- 1 root root 19295 5月 6 2022 settings.json.template drwxr-xr-x 8 root root 208 5月 6 2022 src -rw-r--r-- 1 root root 695 5月 6 2022 start.bat lrwxrwxrwx 1 root root 9 6月 8 10:43 tests -> src/tests drwxr-xr-x 2 root root 24 5月 6 2022 var #安装Etherpad依赖初始化 [root@sre ~]# cd etherpad-lite/bin [root@sre bin]# ./installDeps.sh 

2.3 修改Etherpad配置文件

Etherpad 默认的数据库是SQLite，本次我们修改成mysql，并且提前创建好数据库实列

trustProxy = ‘true’ ，用于指示Etherpad是否应该信任代理服务器发送的X-Forwarded-*标头。用于使用 nginx 的代理到Etherpad

开启Etherpad 后台管理功能，修改默认的用户名密码

2.3.1 修改数据据库类型

#为Etherpad创建一个数据库和用户,用户名/密码：etherpad/etherpad@2023 MariaDB [(none)]> CREATE DATABASE etherpad; MariaDB [(none)]> GRANT ALL PRIVILEGES ON etherpad.* TO 'etherpad'@'localhost' IDENTIFIED BY 'etherpad@2023'; MariaDB [(none)]> FLUSH PRIVILEGES; MariaDB [(none)]> \q #根据模板文件创建新的配置文件 [root@sre ~]# cd /root/etherpad-lite/ [root@sre etherpad-lite]# cp settings.json.template settings.json [root@sre etherpad-lite]# vim settings.json #修改配置文件 #注释掉dbType": "dirty 几行 /* "dbType": "dirty", "dbSettings": { "filename": "var/dirty.db" }, /* #去掉mysql的注释，配置mysql 用户信息 "dbType" : "mysql", "dbSettings" : { "user": "etherpad", "host": "localhost", "port": 3306, "password": "etherpad@2023", "database": "etherpad", "charset": "utf8mb4" }, 

image-

2.3.2 配置trustProxy = ‘true’

用于指示Etherpad是否应该信任代理服务器发送的X-Forwarded-*标头。用于使用 nginx 的代理到Etherpad

欢迎大家来到IT世界,在知识的湖畔探索吧![root@sre ~]# cd /root/etherpad-lite/ [root@sre etherpad-lite]# vim settings.json "trustProxy": true, 

image-

2.3.3 开启Etherpad 后台管理，修改管理员用户名密码[root@sre ~]# cd /root/etherpad-lite/
[root@sre etherpad-lite]
# vim settings.json

“users”: {
“admin”: {
“password”: “etherpad@2023”,
“is_admin”: true
},
},

image-

2.4 前台运行Etherpad

官方默认的启动脚本 会运行在控制台前台

[root@sre ~]# cd etherpad-lite/bin [root@sre bin]# ./run.sh --root 

image-027324

• 端口监听在 0.0.0.0:9001 上 ，关闭控制台 Etherpad服务就会退出了，不推荐前台运行Etherpad

2.5 后台运行Etherpad

编写一个启动脚本，放在后台运行即可

欢迎大家来到IT世界,在知识的湖畔探索吧![root@sre ~ ]# cd /root/etherpad-lite [root@sre etherpad-lite ]# vim start.sh nohup /root/etherpad-lite/bin/run.sh --root >> /root/etherpad-lite/output.log 2>&1 & [root@sre etherpad-lite ]# ./stgart.sh 

2.6 访问Etherpad

三、常用插件安装

Etherpad提供丰富的插件库，截至文本时间，已经有超过290款插件。

• 使用管理界面安装插件 使用管理界面 `http://ip:port/admin/plugins`, 在线安装

插件名称版本备注font_color0.0.63支持修改字体颜色font_size0.0.63支持修改字体大小image_upload1.0.101支持上传图片markdown0.1.50支持编辑并导出markdown格式sticky_attributes0.1.13支持添加对属性的支持，以粘贴在插入符号位置IE按下加粗按钮，创建粗体文本。适用于下划线、斜体、粗体tables41.0.5支持将表格插入到文档中todo_list0.1.2支持将待办事项列表插入到文档中ether-o-meter0.0.11显示指标，比如CPU 磁盘 内存 等等
desktop_notifications0.1.34接收聊天桌面通知

3.1 使用管理界面在线安装插件

• 登录插件管理的后台，输入管理员用户名密码

image-

• 找到自己需要的插件直接 Install 即可

image-

四、其他功能配置

4.1「自定义界面风格」

通过访问http://172.16.10.37:9001/p/test#skinvariantsbuilder，即设置编辑器的风格。

Etherpad 支持设置顶部菜单、背景区、编辑区的背景，提供了四种不同的样式用于选择，想用哪种随你选。

4.2「使用Nginx 代理」

Nginx 安装过程省略，这里只贴出代理的nginx配置文件，注意Etherpad 的配置文件中的要设置成 trustProxy = ‘true’

[root@sre offline]# cat etherpad.conf 
server {
        listen       80;
        listen 443 ssl;
        server_name  etherpad.xxx.link;
        root         /usr/share/nginx/html;
        ssl_certificate /etc/opt/rh/rh-nginx116/nginx/cert/xxx/xxx.crt;
        ssl_certificate_key /etc/opt/rh/rh-nginx116/nginx/cert/xxx.link/xxx.key;
        ssl_session_timeout 5m;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
        ssl_prefer_server_ciphers on;

        location / {
        proxy_pass http://172.16.10.37:9001;
        client_max_body_size 200m;
        proxy_set_header            Host $host;
        proxy_set_header            X-real-ip $remote_addr;
        proxy_set_header            X-Forwarded-For $remote_addr;
        }

        error_page 404 /404.html;
            location = /40x.html {
        }

        error_page 500 502 503 504 /50x.html;
            location = /50x.html {
        }
    }

五、参考

• https://developer.aliyun.com/article/?accounttraceid=de974e40289e418c99e0c57ae3d80d11irqk
• https://cloud.tencent.com/developer/article/