浏览代码

Update and improve manual install doc

j8
C0rn3j 5 年前
父节点
当前提交
53f937ba4e
共有 1 个文件被更改,包括 26 次插入24 次删除
  1. 26
    24
      doc/manual-install.md

+ 26
- 24
doc/manual-install.md 查看文件

1
 # Server Installation for Jitsi Meet
1
 # Server Installation for Jitsi Meet
2
 
2
 
3
-
4
-:warning: **WARNING:** Manual installation is not recommended. We recommend following the [quick-install](https://github.com/jitsi/jitsi-meet/blob/master/doc/quick-install.md) document. The current document describes the steps that are needed to install a working deployment, but steps are easy to mess up, and the debian packages are more up-to-date, where this document sometimes is not updated to latest changes.
5
-
6
-
3
+:warning: **WARNING:** Manual installation is not recommended. We recommend following the [quick-install](https://github.com/jitsi/jitsi-meet/blob/master/doc/quick-install.md) document. The current document describes the steps that are needed to install a working deployment, but steps are easy to mess up, and the debian packages are more up-to-date, where this document is sometimes not updated to reflect latest changes.
7
 
4
 
8
 This describes configuring a server `jitsi.example.com` running Debian or a Debian Derivative. You will need to
5
 This describes configuring a server `jitsi.example.com` running Debian or a Debian Derivative. You will need to
9
 change references to that to match your host, and generate some passwords for
6
 change references to that to match your host, and generate some passwords for
22
                   443                          |
19
                   443                          |
23
                +-------+                       |
20
                +-------+                       |
24
                |       |                       |
21
                |       |                       |
25
-               | NginX |                       |
22
+               | Nginx |                       |
26
                |       |                       |
23
                |       |                       |
27
                +--+-+--+                       |
24
                +--+-+--+                       |
28
                   | |                          |
25
                   | |                          |
31
 | jitsi-meet +<---+ +--->+ prosody/xmpp |      |
28
 | jitsi-meet +<---+ +--->+ prosody/xmpp |      |
32
 |            |files 5280 |              |      |
29
 |            |files 5280 |              |      |
33
 +------------+           +--------------+      v
30
 +------------+           +--------------+      v
34
-                     5222,5347^    ^5347      4443
31
+                     5222,5347^    ^5347   4443,10000
35
                 +--------+    |    |    +-------------+
32
                 +--------+    |    |    +-------------+
36
                 |        |    |    |    |             |
33
                 |        |    |    |    |             |
37
                 | jicofo +----^    ^----+ videobridge |
34
                 | jicofo +----^    ^----+ videobridge |
112
 prosodyctl restart
109
 prosodyctl restart
113
 ```
110
 ```
114
 
111
 
115
-## Install nginx
112
+## Install Nginx
116
 ```sh
113
 ```sh
117
 apt-get install nginx
114
 apt-get install nginx
118
 ```
115
 ```
122
 server_names_hash_bucket_size 64;
119
 server_names_hash_bucket_size 64;
123
 
120
 
124
 server {
121
 server {
125
-    listen 443;
122
+    listen 0.0.0.0:443 ssl http2;
123
+    listen [::]:443 ssl http2;
126
     # tls configuration that is not covered in this guide
124
     # tls configuration that is not covered in this guide
127
     # we recommend the use of https://certbot.eff.org/
125
     # we recommend the use of https://certbot.eff.org/
128
     server_name jitsi.example.com;
126
     server_name jitsi.example.com;
129
     # set the root
127
     # set the root
130
-    root /srv/jitsi.example.com;
128
+    root /srv/jitsi-meet;
131
     index index.html;
129
     index index.html;
132
     location ~ ^/([a-zA-Z0-9=\?]+)$ {
130
     location ~ ^/([a-zA-Z0-9=\?]+)$ {
133
         rewrite ^/(.*)$ / break;
131
         rewrite ^/(.*)$ / break;
152
 ```
150
 ```
153
 
151
 
154
 ## Install Jitsi Videobridge
152
 ## Install Jitsi Videobridge
153
+Visit https://download.jitsi.org/jitsi-videobridge/linux to determine the current build number, download and unzip it:
155
 ```sh
154
 ```sh
156
 wget https://download.jitsi.org/jitsi-videobridge/linux/jitsi-videobridge-linux-{arch-buildnum}.zip
155
 wget https://download.jitsi.org/jitsi-videobridge/linux/jitsi-videobridge-linux-{arch-buildnum}.zip
157
 unzip jitsi-videobridge-linux-{arch-buildnum}.zip
156
 unzip jitsi-videobridge-linux-{arch-buildnum}.zip
164
 
163
 
165
 _NOTE: When installing on older Debian releases keep in mind that you need JRE >= 1.7._
164
 _NOTE: When installing on older Debian releases keep in mind that you need JRE >= 1.7._
166
 
165
 
167
-In the user home that will be starting Jitsi Videobridge create `.sip-communicator` folder and add the file `sip-communicator.properties` with one line in it:
168
-```
169
-org.jitsi.impl.neomedia.transform.srtp.SRTPCryptoContext.checkReplay=false
166
+Create `~/.sip-communicator/sip-communicator.properties` in the home folder of the user that will be starting Jitsi Videobridge:
167
+```sh
168
+mkdir -p ~/.sip-communicator
169
+echo "org.jitsi.impl.neomedia.transform.srtp.SRTPCryptoContext.checkReplay=false" > ~/.sip-communicator/sip-communicator.properties
170
 ```
170
 ```
171
 
171
 
172
 Start the videobridge with:
172
 Start the videobridge with:
191
 ```sh
191
 ```sh
192
 git clone https://github.com/jitsi/jicofo.git
192
 git clone https://github.com/jitsi/jicofo.git
193
 ```
193
 ```
194
-Build distribution package. Replace {os-name} with one of: 'lin', 'lin64', 'macosx', 'win', 'win64'.
194
+Build the package.
195
 ```sh
195
 ```sh
196
 cd jicofo
196
 cd jicofo
197
 mvn package -DskipTests -Dassembly.skipAssembly=false
197
 mvn package -DskipTests -Dassembly.skipAssembly=false
199
 Run jicofo:
199
 Run jicofo:
200
 ```sh
200
 ```sh
201
 =======
201
 =======
202
-unzip target/jicofo-{os-name}-1.0-SNAPSHOT.zip
203
-cd jicofo-{os-name}-1.0-SNAPSHOT'
202
+unzip target/jicofo-1.1-SNAPSHOT-archive.zip
203
+cd jicofo-1.1-SNAPSHOT-archive'
204
 ./jicofo.sh --host=localhost --domain=jitsi.example.com --secret=YOURSECRET2 --user_domain=auth.jitsi.example.com --user_name=focus --user_password=YOURSECRET3
204
 ./jicofo.sh --host=localhost --domain=jitsi.example.com --secret=YOURSECRET2 --user_domain=auth.jitsi.example.com --user_name=focus --user_password=YOURSECRET3
205
 ```
205
 ```
206
 
206
 
209
 ```sh
209
 ```sh
210
 cd /srv
210
 cd /srv
211
 git clone https://github.com/jitsi/jitsi-meet.git
211
 git clone https://github.com/jitsi/jitsi-meet.git
212
-mv jitsi-meet/ jitsi.example.com
213
-cd jitsi.example.com
212
+cd jitsi-meet
214
 npm install
213
 npm install
215
 make
214
 make
216
 ```
215
 ```
217
 
216
 
218
-Edit host names in `/srv/jitsi.example.com/config.js` (see also the example config file):
217
+Edit host names in `/srv/jitsi-meet/config.js` (see also the example config file):
219
 ```
218
 ```
220
 var config = {
219
 var config = {
221
     hosts: {
220
     hosts: {
231
 };
230
 };
232
 ```
231
 ```
233
 
232
 
234
-Restart nginx to get the new configuration:
233
+Verify that nginx config is valid and reload nginx:
235
 ```sh
234
 ```sh
236
-invoke-rc.d nginx restart
235
+nginx -t && nginx -s reload
237
 ```
236
 ```
238
 
237
 
239
 ## Running behind NAT
238
 ## Running behind NAT
240
-Jitsi-Videobridge can run behind a NAT, provided that all required ports are routed (forwarded) to the machine that it runs on. By default these ports are (TCP/443 or TCP/4443 and UDP 10000).
239
+Jitsi Videobridge can run behind a NAT, provided that both required ports are routed (forwarded) to the machine that it runs on. By default these ports are `TCP/4443` and `UDP/10000`.
240
+
241
+If you do not route these two ports, Jitsi Meet will only work with video for two people, breaking upon 3 or more people trying to show video.
241
 
242
 
242
-The following extra lines need to be added the file `~/.sip-communicator/sip-communicator.properties` (in the home directory of the user running the videobridge):
243
+`TCP/443` is required for the webserver which can be running on another machine than the Jitsi Videobrige is running on.
244
+
245
+The following extra lines need to be added to the file `~/.sip-communicator/sip-communicator.properties` (in the home directory of the user running the videobridge):
243
 ```
246
 ```
244
 org.ice4j.ice.harvest.NAT_HARVESTER_LOCAL_ADDRESS=<Local.IP.Address>
247
 org.ice4j.ice.harvest.NAT_HARVESTER_LOCAL_ADDRESS=<Local.IP.Address>
245
 org.ice4j.ice.harvest.NAT_HARVESTER_PUBLIC_ADDRESS=<Public.IP.Address>
248
 org.ice4j.ice.harvest.NAT_HARVESTER_PUBLIC_ADDRESS=<Public.IP.Address>
248
 # Hold your first conference
251
 # Hold your first conference
249
 You are now all set and ready to have your first meet by going to http://jitsi.example.com
252
 You are now all set and ready to have your first meet by going to http://jitsi.example.com
250
 
253
 
251
-
252
 ## Enabling recording
254
 ## Enabling recording
253
-[Jibri](https://github.com/jitsi/jibri)is a set of tools for recording and/or streaming a Jitsi Meet conference.
255
+[Jibri](https://github.com/jitsi/jibri) is a set of tools for recording and/or streaming a Jitsi Meet conference.

正在加载...
取消
保存