1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
# Build
We'll only cover the build process on Linux since we will be providing Windows and macOS binaries. Building trojan on every platform is similar.
## Dependencies
Install these dependencies before you build (note that the test has some [additional dependencies](https://github.com/trojan-gfw/trojan/blob/master/tests/LinuxSmokeTest/README.md)):
- [CMake](https://cmake.org/) >= 3.7.2
- [Boost](http://www.boost.org/) >= 1.66.0
- [OpenSSL](https://www.openssl.org/) >= 1.1.0
- [libmysqlclient](https://dev.mysql.com/downloads/connector/c/)
For Debian users, run `sudo apt -y install build-essential cmake libboost-system-dev libboost-program-options-dev libssl-dev default-libmysqlclient-dev` to install all the necessary dependencies.
## Clone
Type in
```bash
git clone https://github.com/trojan-gfw/trojan.git
cd trojan/
```
to clone the project and go into the directory.
## Build and Install
Type in
```bash
mkdir build
cd build/
cmake ..
make
ctest
sudo make install
```
to build, test, and install trojan. If everything goes well you'll be able to use trojan.
The `cmake ..` command can be extended with the following options:
- `-DDEFAULT_CONFIG=/path/to/default/config.json`: the default path trojan will look for config (defaults to `${CMAKE_INSTALL_FULL_SYSCONFDIR}/trojan/config.json`).
- `ENABLE_MYSQL`
- `-DENABLE_MYSQL=ON`: build with MySQL support (default).
- `-DENABLE_MYSQL=OFF`: build without MySQL support.
- `ENABLE_NAT` (Only on Linux)
- `-DENABLE_NAT=ON`: build with NAT support (default).
- `-DENABLE_NAT=OFF`: build without NAT support.
- `ENABLE_REUSE_PORT` (Only on Linux)
- `-DENABLE_REUSE_PORT=ON`: build with `SO_REUSEPORT` support (default).
- `-DENABLE_REUSE_PORT=OFF`: build without `SO_REUSEPORT` support.
- `ENABLE_SSL_KEYLOG` (OpenSSL >= 1.1.1)
- `-DENABLE_SSL_KEYLOG=ON`: build with SSL KeyLog support (default).
- `-DENABLE_SSL_KEYLOG=OFF`: build without SSL KeyLog support.
- `ENABLE_TLS13_CIPHERSUITES` (OpenSSL >= 1.1.1)
- `-DENABLE_TLS13_CIPHERSUITES=ON`: build with TLS1.3 ciphersuites support (default).
- `-DENABLE_TLS13_CIPHERSUITES=OFF`: build without TLS1.3 ciphersuites support.
- `FORCE_TCP_FASTOPEN`
- `-DFORCE_TCP_FASTOPEN=ON`: force build with `TCP_FASTOPEN` support.
- `-DFORCE_TCP_FASTOPEN=OFF`: build with `TCP_FASTOPEN` support based on system capabilities (default).
- `SYSTEMD_SERVICE`
- `-DSYSTEMD_SERVICE=AUTO`: detect systemd automatically and decide whether to install service (default).
- `-DSYSTEMD_SERVICE=ON`: install systemd service unconditionally.
- `-DSYSTEMD_SERVICE=OFF`: don't install systemd service unconditionally.
- `-DSYSTEMD_SERVICE_PATH=/path/to/systemd/system`: the path to which the systemd service will be installed (defaults to `/lib/systemd/system`).
After installation, config examples will be installed to `${CMAKE_INSTALL_DOCDIR}/examples/` and a server config will be installed to `${CMAKE_INSTALL_FULL_SYSCONFDIR}/trojan/config.json`.
[Homepage](.) | [Prev Page](authenticator) | [Next Page](usage)
|
