@@ -25,7 +25,71 @@ make tpls
25
25
```
26
26
Then compile the project like above.
27
27
28
- ## Usage for compiled application
28
+ ## Examples
29
+ Start server on port 8080, root directory is current working directory:
30
+ ``` sh
31
+ server -l 8080
32
+ ```
33
+
34
+ Start server on port 8080, root directory is /usr/share/doc:
35
+ ``` sh
36
+ server -l 8080 -r /usr/share/doc
37
+ ```
38
+
39
+ Start server on default port, root directory is /tmp, and allow upload files to file system directory /tmp/data:
40
+ ``` sh
41
+ server -r /tmp -u /data
42
+ ```
43
+
44
+ Share files from /etc, but also mount /usr/share/doc to url path /doc
45
+ ``` sh
46
+ server -r /etc -a :/doc:/usr/share/doc
47
+ ```
48
+
49
+ Start server on port 8080, serve for HTTPS protocol
50
+ ``` sh
51
+ server -k /path/to/certificate/key -c /path/to/certificate/file -l 8080
52
+ ```
53
+
54
+ Do not show hidden unix directories and files that starts with ` . ` .
55
+ Tips: wrap wildcard by quotes to prevent expanding by shell.
56
+ ``` sh
57
+ server -H ' .*'
58
+ ```
59
+
60
+ Show access log on console:
61
+ ``` sh
62
+ server -L -
63
+ ```
64
+
65
+ Http Basic Auth:
66
+ - requires authentication for url /files
67
+ - username: user1, password: pass1
68
+ - username: user2, password: pass2
69
+ ``` sh
70
+ server --auth /files --user user1:pass1 --user-sha1 user2:8be52126a6fde450a7162a3651d589bb51e9579d
71
+ ```
72
+
73
+ Start 2 virtual hosts:
74
+ - server 1
75
+ - listen on port 80 for http
76
+ - listen on port 443 for https
77
+ - cert file: /cert/server1.pem
78
+ - key file: /cert/server1.key
79
+ - hostname: server1.example.com
80
+ - root directory: /var/www/server1
81
+ - server 2
82
+ - listen on port 80 for http
83
+ - listen on port 443 for https
84
+ - cert file: /cert/server2.pem
85
+ - key file: /cert/server2.key
86
+ - hostname: server2.example.com
87
+ - root directory: /var/www/server2
88
+ ``` sh
89
+ server --listen-plain 80 --listen-tls 443 -c /cert/server1.pem -k /cert/server1.key --hostname server1.example.com -r /var/www/server1 ,, --listen-plain 80 --listen-tls 443 -c /cert/server2.pem -k /cert/server2.key --hostname server2.example.com -r /var/www/server2
90
+ ```
91
+
92
+ ## Usage
29
93
```
30
94
server [options]
31
95
@@ -165,67 +229,3 @@ server [options]
165
229
server will try to use first virtual host that has no hostname,
166
230
otherwise use the first virtual host.
167
231
```
168
-
169
- ## Examples
170
- Start server on port 8080, root directory is current working directory:
171
- ``` sh
172
- server -l 8080
173
- ```
174
-
175
- Start server on port 8080, root directory is /usr/share/doc:
176
- ``` sh
177
- server -l 8080 -r /usr/share/doc
178
- ```
179
-
180
- Start server on default port, root directory is /tmp, and allow upload files to file system directory /tmp/data:
181
- ``` sh
182
- server -r /tmp -u /data
183
- ```
184
-
185
- Share files from /etc, but also mount /usr/share/doc to url path /doc
186
- ``` sh
187
- server -r /etc -a :/doc:/usr/share/doc
188
- ```
189
-
190
- Start server on port 8080, serve for HTTPS protocol
191
- ``` sh
192
- server -k /path/to/certificate/key -c /path/to/certificate/file -l 8080
193
- ```
194
-
195
- Do not show hidden unix directories and files that starts with ` . ` .
196
- Tips: wrap wildcard by quotes to prevent expanding by shell.
197
- ``` sh
198
- server -H ' .*'
199
- ```
200
-
201
- Show access log on console:
202
- ``` sh
203
- server -L -
204
- ```
205
-
206
- Http Basic Auth:
207
- - requires authentication for url /files
208
- - username: user1, password: pass1
209
- - username: user2, password: pass2
210
- ``` sh
211
- server --auth /files --user user1:pass1 --user-sha1 user2:8be52126a6fde450a7162a3651d589bb51e9579d
212
- ```
213
-
214
- Start 2 virtual hosts:
215
- - server 1
216
- - listen on port 80 for http
217
- - listen on port 443 for https
218
- - cert file: /cert/server1.pem
219
- - key file: /cert/server1.key
220
- - hostname: server1.example.com
221
- - root directory: /var/www/server1
222
- - server 2
223
- - listen on port 80 for http
224
- - listen on port 443 for https
225
- - cert file: /cert/server2.pem
226
- - key file: /cert/server2.key
227
- - hostname: server2.example.com
228
- - root directory: /var/www/server2
229
- ``` sh
230
- server --listen-plain 80 --listen-tls 443 -c /cert/server1.pem -k /cert/server1.key --hostname server1.example.com -r /var/www/server1 ,, --listen-plain 80 --listen-tls 443 -c /cert/server2.pem -k /cert/server2.key --hostname server2.example.com -r /var/www/server2
231
- ```
0 commit comments