dae/docs/getting-started/README.md

67 lines
1.5 KiB
Markdown
Raw Normal View History

2023-02-19 14:54:44 +07:00
# Quick Start Guide
## Linux Kernel Requirement
### Kernel Version
Use `uname -r` to check the kernel version on your machine.
> **Notes**
> If you find your kernel version is `< 5.8`, follow the guide [HERE](./kernel-upgrade.md) to upgrade the kernel to the minimum required version.
2023-02-19 15:14:33 +07:00
## Usage
2023-02-19 14:54:44 +07:00
2023-02-19 15:14:33 +07:00
### Build
2023-02-19 14:54:44 +07:00
2023-02-19 15:14:33 +07:00
**Make Dependencies**
2023-02-19 14:54:44 +07:00
2023-02-19 15:14:33 +07:00
```shell
clang >= 10
llvm >= 10
golang >= 1.18
make
```
2023-02-19 14:54:44 +07:00
2023-02-19 15:14:33 +07:00
**Build**
2023-02-19 14:54:44 +07:00
```shell
2023-02-19 15:14:33 +07:00
git clone https://github.com/v2rayA/dae.git
cd dae
git submodule update --init
# Minimal dependency build:
make GOFLAGS="-buildvcs=false" CC=clang
# Or normal build:
# make
2023-02-19 14:54:44 +07:00
```
2023-02-19 15:14:33 +07:00
### Run
2023-02-19 14:54:44 +07:00
2023-02-19 15:14:33 +07:00
**Runtime Dependencies**
2023-02-19 14:54:44 +07:00
2023-02-25 01:55:17 +07:00
For traffic splitting, dae relies on the following data sources, [geoip.dat](https://github.com/v2ray/geoip/releases/latest) and [geosite.dat](https://github.com/v2fly/domain-list-community/releases/latest).
2023-02-19 14:54:44 +07:00
2023-02-20 23:41:30 +07:00
```shell
2023-02-19 15:14:33 +07:00
mkdir -p /usr/local/share/dae/
pushd /usr/local/share/dae/
curl -L -o geoip.dat https://github.com/v2ray/geoip/releases/latest/download/geoip.dat
curl -L -o geosite.dat https://github.com/v2ray/domain-list-community/releases/latest/download/dlc.dat
popd
2023-02-20 23:41:30 +07:00
2023-02-19 14:54:44 +07:00
```
2023-02-19 15:14:33 +07:00
**Run**
2023-02-19 14:54:44 +07:00
2023-02-21 11:45:26 +07:00
Download the example config file:
```shell
curl -L -o example.dae https://github.com/v2rayA/dae/raw/main/example.dae
```
See [example.dae](https://github.com/v2rayA/dae/blob/main/example.dae).
After fine tuning, run dae:
2023-02-19 14:54:44 +07:00
```shell
2023-02-19 15:14:33 +07:00
./dae run -c example.dae
2023-02-19 14:54:44 +07:00
```
2023-02-25 01:55:17 +07:00
Alternatively, you may run dae as a daemon(systemd) service. Check out more details [HERE](./run-as-daemon.md).
2023-02-20 23:41:30 +07:00