如何在VPS上使用Node.js和MySQL安装Etherpad进行生产
状态: 已弃用
本文介绍了不再受支持的 CentOS 版本。 如果您目前正在运行运行 CentOS 6 的服务器,我们强烈建议您升级或迁移到受支持的 CentOS 版本。
原因: CentOS 6 已于 2020 年 11 月 30 日结束生命周期 (EOL) and no longer receives security patches or updates. For this reason, this guide is no longer maintained.
请参阅:
本指南可能仍可用作参考,但可能不适用于其他 CentOS 版本。 如果可用,我们强烈建议使用为您使用的 CentOS 版本编写的指南。
介绍
Etherpad 是一个实时的多用户协作工具,主要用于程序开发和网页设计。 在本教程中,我们将专注于让 Etherpad 在 CentOS 6.4 VPS(云服务器)上运行。 本指南将认为您已经进行了设置,如果您没有,只需按照本指南 此处 进行操作。
第 1 步 - 安装所需的库
在我们安装 Etherpad 之前,我们需要安装所需的库和先决条件。
继续并以 root 或在每个命令的开头添加 sudo 来执行以下命令。
yum install gzip git-core curl python openssl-devel make gcc gcc-c++ postgresql-devel && yum -y groupinstall "Development Tools"
完成后,您需要安装 Node.JS 库和 NPM 库。 所以执行以下命令:
cd /tmp wget http://mirror-fpt-telecom.fpt.net/fedora/epel/6/i386/epel-release-6-8.noarch.rpm rpm -ivh epel-release-6-8.noarch.rpm yum install nodejs npm
恭喜,Node.JS 和 NPM 已安装。 现在我们可以开始安装 Etherpad!
第 2 步 - 安装 Etherpad
首先,我们将为 Etherpad 创建一个单独的用户。 这将允许 Etherpad 独立于其他用户运行,并且比使用 root 更安全。 此命令还将创建用户以及主目录。
useradd --create-home etherpad
现在,我们将执行一些命令,以便我们可以将 Etherpad 配置为新创建的用户。
su - etherpad cd /home/etherpad
为了让 Etherpad 运行,我们需要先下载它。 执行以下命令以从 GitHub 启动下载。
git clone git://github.com/ether/etherpad-lite.git
第 3 步 - 为 Etherpad 数据库安装 MySQL
虽然 Etherpad 使用它自己的平面文件数据库进行存储,但不建议将其用于生产用途。 因此,我们将安装 MySQL 并将 Etherpad 配置为用作数据库。
我们假设您当前没有安装 MySQL,因此以 root 或使用 sudo 运行以下命令:
yum install mysql-server service mysqld start chkconfig mysqld on
安装后,运行这些命令。 请务必将 PASSWORD 替换为您选择的安全密码:
mysql -u root -p create database `etherpad-lite`; grant all privileges on `etherpad-lite`.* to 'etherpad'@'localhost' identified by 'PASSWORD'; exit
现在,我们需要进入 Etherpad 目录,因此执行以下命令:
su - etherpad cd /home/etherpad/etherpad-lite cp settings.json.template settings.json
使用您喜欢的编辑器打开 settings.json 文件。
找到以下文本:
"sessionKey" : "",
将其更改为:
"sessionKey" : "SECURESTRING",
显而易见,将 SECURESTRING 替换为 10-18 字母数字字符串。
然后找到:
"dbType" : "dirty", //the database specific settings "dbSettings" : { "filename" : "var/dirty.db" },
并像这样评论它:
// "dbType" : "dirty", */ //the database specific settings // "dbSettings" : { // "filename" : "var/dirty.db" // },
然后找到:
/* An Example of MySQL Configuration "dbType" : "mysql", "dbSettings" : { "user" : "root", "host" : "localhost", "password": "", "database": "store" }, */
将其更改为以下内容(注意确保最后删除 */):
// Etherpad MySQL Config "dbType" : "mysql", "dbSettings" : { "user" : "etherpad", "host" : "localhost", "port" : "/var/lib/mysql/mysql.sock", "password": "YOURDBPASSWORD", "database": "etherpad-lite" },
请务必将 YOURDBPASSWORD 替换为您在创建数据库时设置的密码。 保存文件,然后关闭编辑器。
现在我们需要让 Etherpad 为自己安装一些依赖项。 所以执行以下命令:
./bin/installDeps.sh
一旦运行完成,我们将需要第一次运行 Etherpad,以便它可以在数据库中创建适当的表。 运行以下命令:
./bin/run.sh
Etherpad 加载成功后,使用 Ctrl+C 杀死进程。 在真正运行之前,我们需要修改 Etherpad 数据库以供使用:
mysql -u root -p alter database `etherpad-lite` character set utf8 collate utf8_bin; use `etherpad-lite`; alter table `store` convert to character set utf8 collate utf8_bin; exit
第 4 步 - 运行 Etherpad
我们已成功安装 Etherpad 并将其配置为使用 MySQL。 从这一点来说,为了正确运行它,执行:
./bin/run.sh
该脚本将初始化 Etherpad,然后启动该过程。
请记住,当您取消/关闭 SSH 会话窗口时,Etherpad 将终止。 您可以使用可选步骤将 Etherpad 置于屏幕会话中,以便于管理。
第 5 步 - 访问 Etherpad
运行上述脚本后,您可以通过浏览以下网址访问您的 Etherpad 安装:http://yourdomain.com:9001
您应该看到一个 Etherpad 页面,要求您创建一个 pad 或打开一个现有的。
第 6 步 - 在屏幕中运行 Etherpad(可选)
如果您的客户端意外终止,使用 screen 可以为您节省宝贵的时间。 它允许您保持会话活动并随时返回,即使您已注销或 SSH 客户端意外退出。
要安装 screen 程序,只需以 root (su) 或 超级用户 (sudo) 执行以下命令
yum install screen
安装后,只需执行以下命令即可在屏幕中运行 Etherpad。
su - etherpad cd /home/etherpad screen -dmS etherpad ./etherpad-lite/bin/run.sh
Etherpad 应立即在后台运行。
为了查看您的屏幕会话,您需要注销并使用您的 Etherpad 用户登录,但我们必须先为其创建一个密码。 以 root 身份运行以下命令,为 Etherpad 用户创建密码:
passwd etherpad
完成后,您可以退出当前的 SSH 会话并以 Etherpad 用户身份登录。
以您的 Etherpad 用户身份登录后,运行以下命令以重新连接到您的屏幕会话:
screen -r etherpad
要从屏幕分离并返回 bash 提示符,只需同时按 CtrlA+D'。 即 Control-A 后跟一个 D.'
注意:如果 VPS 断电或重新启动,屏幕会话将丢失。 您将需要再次运行命令或使用启动脚本,例如在 here 中找到的脚本。
第 7 步 - 附加配置
本指南仅展示了设置 Etherpad 的基础知识。 您可以采取其他措施来改进 Etherpad 安装,但此处未介绍。
有关进一步配置 Etherpad 的更多信息,请访问 Etherpad Wiki:https://github.com/ether/etherpad-lite/wiki。