Add notification server of cluster (#183)

* Add notification server of cluster * Update notification-server.md --------- Co-authored-by: heran yang <[email protected]> Co-authored-by: Jiaqiang Xu <[email protected]>
haiwen · Jul 24, 2023 · fc4c12a · fc4c12a
1 parent bc152ae
commit fc4c12a
Showing 1 changed file with 59 additions and 0 deletions.
diff --git a/manual/deploy_pro/notification-server.md b/manual/deploy_pro/notification-server.md
@@ -0,0 +1,59 @@
+# Notification Server Overview
+
+In Seafile Pro edition, the notification server is the same as [community edition notification server](../deploy/notification-server.md).
+
+If you enable [clustering](./deploy_in_a_cluster.md), You need to deploy notification server on one of the servers. The reverse proxy (nginx or apache) on other front-end nodes should forward websockets requests to this node. The notification server configuration corresponding to each node of the cluster is as follows.
+
+The notification server configuration should be the same as in community edition:
+
+```
+[notification]
+enabled = true
+# the ip of notification server.
+host = 192.168.1.134
+# the port of notification server
+port = 8083
+# the log level of notification server
+log_level = info
+# jwt_private_key is used to generate jwt token and authenticate seafile server
+jwt_private_key = M@O8VWUb81YvmtWLHGB2I_V7di5-@0p(MF*GrE!sIws23F
+```
+
+The nginx or Apache configuration of the cluster nodes should be the same, but forwarding requests to notification server node, instead of a local port.
+
+We generally recommend deploying notification server behind nginx, the notification server can be supported by adding the following nginx configuration:
+
+```
+map $http_upgrade $connection_upgrade {
+default upgrade;
+'' close;
+}
+
+server {
+    location /notification/ping {
+        proxy_pass http://192.168.1.134:8083/ping;
+        access_log      /var/log/nginx/notif.access.log;
+        error_log       /var/log/nginx/notif.error.log;
+    }
+
+    location /notification {
+        proxy_pass http://192.168.1.134:8083/;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        access_log      /var/log/nginx/notif.access.log;
+        error_log       /var/log/nginx/notif.error.log;
+    }
+}
+
+```
+
+Or add the configuration for Apache:
+
+```
+    ProxyPass /notification/ping  http://192.168.1.134:8083/ping/
+    ProxyPassReverse /notification/ping  http://192.168.1.134:8083/ping/
+
+    ProxyPass /notification  ws://192.168.1.134:8083/
+    ProxyPassReverse /notification ws://192.168.1.134:8083/
+```