インストールガイド · 3 min read · Oct 13, 2025

Ubuntu 20.04にEtherpadをインストールする方法

Etherpadは、ライターが同時にテキストドキュメントを編集し、すべての編集をリアルタイムで監視できるウェブベースのリアルタイムオンラインエディタです。オープンソースでカスタマイズ可能で、各著者のテキストを自分の色で表示する機能があります。また、ユーザーやグループを管理するためにアプリケーションに統合できるHTTP APIも提供しています。Etherpadにメール通知、ファイルアップロード、ビデオ通話を統合するのに役立ついくつかのプラグインも提供しています。このチュートリアルでは、Ubuntu 20.04サーバーにEtherpadウェブベースのエディタをインストールする方法を示します。

前提条件

  • Ubuntu 20.04を実行しているサーバー。
  • サーバーIPにポイントされた有効なドメイン名。
  • サーバーに設定されたrootパスワード。

始めに

始める前に、システムパッケージを最新バージョンに更新する必要があります。次のコマンドを実行して更新できます。

apt-get update -y

すべてのパッケージが更新されたら、システムにいくつかの依存関係をインストールする必要があります。次のコマンドでそれらをすべてインストールできます。

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

すべてのパッケージがインストールされたら、次のステップに進むことができます。

MariaDBデータベースのインストールと設定

EtherpadはMariaDBをデータベースバックエンドとして使用します。したがって、システムにMariaDBサーバーをインストールする必要があります。次のコマンドでインストールできます。

apt-get install mariadb-server -y

MariaDBをインストールした後、次のコマンドでMariaDBシェルにログインします。

mysql

ログイン後、次のコマンドでEtherpad用のデータベースとユーザーを作成します。

MariaDB [(none)]> create database etherpad;  
MariaDB [(none)]> grant all privileges on etherpad.* to etherpad@localhost identified by 'password';

次に、特権をフラッシュし、次のコマンドでMariaDBから退出します。

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

この時点で、Etherpad用にデータベースが設定されました。次のステップに進むことができます。

Node.jsのインストール

EtherpadはNode.jsに基づいています。したがって、システムにNode.jsをインストールする必要があります。デフォルトでは、Ubuntu 20.04の標準リポジトリには最新バージョンの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

完了したら、次のステップに進むことができます。

Etherpadのインストールと設定

Etherpadをインストールする前に、Etherpadを別のユーザーとして実行することをお勧めします。次のコマンドでEtherpad用の新しいユーザーを作成できます。

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

次のようにパスワードを設定するように求められます。

Adding user `etherpad' ...
Adding new group `etherpad' (1000) ...
Adding new user `etherpad' (1000) with group `etherpad' ...
Creating home directory `/opt/etherpad' ...
Copying files from `/etc/skel' ...
New password: 
Retype new password: 
passwd: password updated successfully
Changing the user information for etherpad
Enter the new value, or press ENTER for the default
    Full Name []: Hitesh       
    Room Number []: 1
    Work Phone []: 
    Home Phone []: 
    Other []: 
Is the information correct? [Y/n] Y

次に、次のコマンドでEtherpadホームディレクトリに適切な権限を付与します。

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

次に、ユーザーをEtherpadに切り替え、次のコマンドを使用してGitリポジトリからEtherpadの最新バージョンをダウンロードします。

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

次に、ダウンロードしたディレクトリに移動し、次のコマンドを使用してEtherpadを実行します。

cd etherpad-lite  
bin/run.sh

これにより、すべての依存関係がインストールされ、Etherpadサーバーが起動します。サーバーが正常に起動すると、次の出力が得られるはずです。

[2020-11-11 06:46:44.783] [INFO] console - Your Etherpad version is 1.8.6 (2c8769a)
[2020-11-11 06:46:44.958] [INFO] console - You can access your Etherpad instance at http://0.0.0.0:9001/
[2020-11-11 06:46:44.958] [WARN] console - Admin username and password not set in settings.json.  To access admin please uncomment and edit 'users' in settings.json
[2020-11-11 06:46:44.958] [WARN] console - Etherpad is running in Development mode.  This mode is slower for users and less secure than production mode.  You should set the NODE_ENV environment variable to production by using: export NODE_ENV=production

次に、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": "password",
    "database": "etherpad",
    "charset":  "utf8mb4"
  },

trustProxyの行をtrueに変更します。

  "trustProxy": true,

管理者ユーザーのパスワードを定義します。

  "users": {
    "admin": {
      "password": "adminpassword",
      "is_admin": true
    },

ファイルを保存して閉じたら、次のコマンドで必要な依存関係をインストールします。

./bin/installDeps.sh

すべての依存関係がインストールされたら、次のコマンドでEtherpadユーザーから退出します。

exit

この時点で、Etherpadがインストールされ、設定されました。次のステップに進むことができます。

Etherpad用のSystemdサービスファイルを作成

次に、Etherpadサービスを管理するためのsystemdサービスファイルを作成する必要があります。次のコマンドで作成できます。

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サービスの状態を確認することもできます。

systemctl status etherpad

次の出力が表示されるはずです。

? etherpad.service - Etherpad-lite, the collaborative editor.
     Loaded: loaded (/etc/systemd/system/etherpad.service; disabled; vendor preset: enabled)
     Active: active (running) since Wed 2020-11-11 06:50:49 UTC; 4s ago
   Main PID: 12269 (node)
      Tasks: 13 (limit: 4691)
     Memory: 119.1M
     CGroup: /system.slice/etherpad.service
             ??12269 /usr/bin/node /opt/etherpad/etherpad-lite/src/node/server.js

Etherpad用のNginxの設定

この時点で、Etherpadは起動し、ポート9001でリッスンしています。次に、EtherpadにアクセスするためのリバースプロキシとしてNginxをインストールして設定する必要があります。まず、次のコマンドで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.mydomain.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に構文エラーがないか確認します。

ginx -t

次の出力が得られるはずです。

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

次に、次のコマンドでNginxサービスを再起動して変更を適用します。

systemctl restart nginx

次のコマンドでNginxの状態を確認することもできます。

systemctl status nginx

次の出力が得られるはずです。

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2020-11-11 06:53:44 UTC; 6s ago
       Docs: man:nginx(8)
    Process: 12984 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 12985 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 13001 (nginx)
      Tasks: 3 (limit: 4691)
     Memory: 3.5M
     CGroup: /system.slice/nginx.service
             ??13001 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
             ??13002 nginx: worker process
             ??13003 nginx: worker process

Nov 11 06:53:44 ubuntu2004 systemd[1]: Starting A high performance web server and a reverse proxy server...
Nov 11 06:53:44 ubuntu2004 systemd[1]: Started A high performance web server and a reverse proxy server.

Etherpadにアクセス

今、ウェブブラウザを開いてURL http://etherpad.mydomain.com を入力します。次のページにリダイレクトされます。

Etherpad

ページ名を入力し、OKボタンをクリックします。次のページにEtherpadダッシュボードが表示されるはずです。

Etherpadオンラインエディタ

結論

おめでとうございます! Ubuntu 20.04サーバーにNginxをリバースプロキシとして使用してEtherpadを正常にインストールおよび設定しました。生産環境でEtherpadを簡単に使用できます。質問があればお気軽にお尋ねください。

Share: X/Twitter LinkedIn

新しい投稿を受信箱で受け取る

スパムはありません。いつでも購読を解除できます。