如何在Ubuntu 20.04上安装Etherpad

Etherpad是一个免费的,开源的,基于Web的多用户协作工具。 它用于通过Web浏览器实时编辑文档。 它使您可以同时编辑,查看和键入文档。 它带有大量的插件,可帮助您自定义实例以满足您的需求。 使用Etherpad,您可以同时与您的朋友,学生或同事一起撰写文章,新闻稿和待办事项清单。

在本教程中,我们将向您展示如何在Ubuntu 20.04上安装Etherpad。

先决条件

  • Ubuntu 20.04 VPS(我们将使用SSD 2 VPS计划)
  • 访问root用户帐户(或访问具有root特权的管理员帐户)

步骤1:登录到服务器并更新服务器操作系统软件包

首先,以root用户身份通过​​SSH登录到Ubuntu 20.04服务器:

ssh [email protected]_Address -p Port_number

您将需要用服务器各自的IP地址和SSH端口号替换“ IP_Address”和“ Port_number”。 此外,如有必要,将“ root”替换为管理员帐户的用户名。

在开始之前,您必须确保服务器上安装的所有Ubuntu OS软件包都是最新的。 您可以通过运行以下命令来执行此操作:

apt-get update -y
apt-get upgrade -y

步骤2:安装所需的软件包

首先,您需要安装在服务器中安装Etherpad所需的所有依赖项。 您可以使用以下命令安装所有组件:

apt-get install libssl-dev pkg-config git gcc g++ make build-essential gnupg2 -y

安装完所有软件包后,您将需要在系统中安装Node.js。 在撰写本教程时,Node.js的最新版本是14.15.0。 默认情况下,Ubuntu 20.04标准存储库中不提供Node.js。 因此,您需要将Node.js存储库安装到系统中。 您可以使用以下命令添加Node.js存储库:

curl -sL https://deb.nodesource.com/setup_14.x -o nodesource_setup.sh
bash nodesource_setup.sh

添加存储库后,使用以下命令安装Node.js:

apt-get install nodejs -y

安装Node.js之后,请使用以下命令验证Node.js的安装版本:

node -v

您应该获得以下输出:

v14.15.0

步骤3:安装和配置MariaDB数据库

Etherpad使用MySQL / MariaDB存储其数据。 因此,必须在您的服务器中安装MariaDB服务器。 如果未安装,则可以使用以下命令进行安装:

apt-get install mariadb-server -y

安装完成后,使用以下命令登录MariaDB控制台:

mysql

登录后,使用以下命令创建数据库和用户:

MariaDB [(none)]> create database etherpaddb;
MariaDB [(none)]> grant all privileges on etherpaddb.* to [email protected] identified by 'secure-password';

接下来,刷新特权并使用以下命令从MariaDB退出:

MariaDB [(none)]> flush privileges;
MariaDB [(none)]> exit;

步骤4:安装和配置Etherpad

首先,创建一个单独的用户来运行Etherpad:

adduser --home /opt/etherpad --shell /bin/bash etherpad

接下来,使用以下命令为Etherpad主目录提供适当的权限:

install -d -m 755 -o etherpad -g etherpad /opt/etherpad

接下来,以Etherpad用户身份登录,并使用以下命令以Etherpad用户身份验证Node.js版本:

su - etherpad
node -v

输出:

v14.15.0

接下来,使用以下命令从Git存储库下载最新版本的Etherpad:

git clone --branch master https://github.com/ether/etherpad-lite.git

接下来,将目录更改为下载的目录,并使用以下命令运行Etherpad:

cd etherpad-lite
bin/run.sh

一旦Etherpad服务器成功启动,请按CTRL + C停止服务器。

接下来,编辑settings.json文件并进行一些更改:

nano settings.json

删除以下行:

"dbType" : "dirty",
  "dbSettings" : {
                   "filename" : "var/dirty.db"
                 },

如下所示更改MySQL设置:

  "dbType" : "mysql",
  "dbSettings" : {
    "user":     "etherpad",
    "host":     "localhost",
    "port":     3306,
    "password": "secure-password",
    "database": "etherpaddb",
    "charset":  "utf8mb4"
  },

将一行trustProxy更改为true:

  "trustProxy": true,

定义管理员用户的密码:

  "users": {
    "admin": {
      "password": "secure-password",
      "is_admin": true
    },

保存并关闭文件,然后使用以下命令安装所需的依赖项:

./bin/installDeps.sh

接下来,使用以下命令从Etherpad用户退出:

exit

步骤5:为Etherpad创建一个Systemd服务文件

接下来,您将需要创建一个systemd服务文件来管理Etherpad服务。

nano /etc/systemd/system/etherpad.service

添加以下行:

[Unit]
Description=Etherpad-lite, the collaborative editor.
After=syslog.target network.target

[Service]
Type=simple
User=etherpad
Group=etherpad
WorkingDirectory=/opt/etherpad/etherpad-lite
Environment=NODE_ENV=production

ExecStart=/usr/bin/node /opt/etherpad/etherpad-lite/src/node/server.js

Restart=always

[Install]
WantedBy=multi-user.target

保存并关闭文件,然后重新加载systemd守护程序以应用更改:

systemctl daemon-reload

接下来,启动Etherpad服务,并使用以下命令启用它以在系统重新启动时启动:

systemctl start etherpad
systemctl enable etherpad

此时,Etherpad已启动并正在侦听端口9001。您可以使用以下命令对其进行验证:

ss -plntu | grep 9001

输出:

tcp   LISTEN 0      511                             0.0.0.0:9001        0.0.0.0:*                                                                                users:(("node",pid=14889,fd=27))   

步骤6:将Nginx配置为反向代理

接下来,您将需要安装Nginx并将其配置为反向代理,以访问Etherpad。

首先,使用以下命令安装Nginx:

apt-get install nginx -y

安装后,创建一个新的Nginx虚拟主机配置文件:

nano /etc/nginx/sites-available/etherpad.conf 

添加以下行:

upstream etherpad {
   server localhost:9001;
   keepalive 32;
}

server {
   listen 80;
   server_name etherpad.example.com;

   location / {
       client_max_body_size 50M;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_http_version 1.1;
       proxy_pass http://etherpad;
   }
}

保存并关闭文件,然后使用以下命令激活Nginx虚拟主机配置文件:

ln -s /etc/nginx/sites-available/etherpad.conf  /etc/nginx/sites-enabled/

接下来,重新启动Nginx服务以应用更改:

systemctl restart nginx

步骤7:访问Etherpad

现在,打开Web浏览器并使用URL访问Etherpad Web界面 http://etherpad.example.com。 您将被重定向到Etherpad仪表板:

将etherpad安装到ubuntu 20.04的指南

提供您的便笺名称,然后单击 按钮。 您将被重定向到Etherpad编辑器,如下所示:

如何将etherpad安装到ubuntu 20.04的指南

恭喜你! 您已成功在Ubuntu 20.04上使用Nginx将Etherpad安装并配置为反向代理。

当然,如果您使用我们的托管Ubuntu托管解决方案之一,则无需在Ubuntu 20.04上安装和配置Etherpad,在这种情况下,您可以简单地要求我们的Linux专业管理员为您在Ubuntu 18.20上设置和配置Etherpad。 。 它们全天候24×7可用,将立即处理您的要求。

PS。 如果您喜欢这篇有关如何在Ubuntu 20.04 VPS上安装Etherpad的文章,请使用下面的共享按钮在社交网络上与您的朋友分享,或者在评论部分中留下评论。 谢谢。

Sidebar