mirror of
https://github.com/3proxy/3proxy.git
synced 2026-06-02 22:40:12 +08:00
Update README.md
This commit is contained in:
parent
2695d83847
commit
086d4cbd6a
59
README.md
59
README.md
@ -2,28 +2,28 @@
|
|||||||
|
|
||||||
(c) 2002-2026 by Vladimir '3APA3A' Dubrovin <vlad@3proxy.org>
|
(c) 2002-2026 by Vladimir '3APA3A' Dubrovin <vlad@3proxy.org>
|
||||||
|
|
||||||
## Branches
|
## Repository
|
||||||
|
|
||||||
|
### Branches
|
||||||
|
|
||||||
- **Master** (stable) branch - 3proxy 0.9
|
- **Master** (stable) branch - 3proxy 0.9
|
||||||
- **Devel** branch - 3proxy 10 (don't use it)
|
- **Devel** branch - 3proxy 10 (don't use it)
|
||||||
|
|
||||||
## Download
|
### Binaries (deb / rpm / Windows zip)
|
||||||
|
|
||||||
# Binaries (deb / rpm / Windows zip)
|
|
||||||
|
|
||||||
https://github.com/3proxy/3proxy/releases
|
https://github.com/3proxy/3proxy/releases
|
||||||
|
|
||||||
# Docker images
|
### Docker images
|
||||||
|
|
||||||
https://hub.docker.com/r/3proxy/3proxy
|
https://hub.docker.com/r/3proxy/3proxy
|
||||||
https://github.com/3proxy/3proxy/pkgs/container/3proxy
|
https://github.com/3proxy/3proxy/pkgs/container/3proxy
|
||||||
|
|
||||||
# Archive of old versions
|
### Archive of old versions
|
||||||
|
|
||||||
https://github.com/z3APA3A/3proxy-archive
|
https://github.com/z3APA3A/3proxy-archive
|
||||||
|
|
||||||
|
|
||||||
## Documentation
|
### Documentation
|
||||||
|
|
||||||
Documentation (man pages and HTML) available with download, on https://3proxy.org/ and in github wiki https://github.com/3proxy/3proxy/wiki
|
Documentation (man pages and HTML) available with download, on https://3proxy.org/ and in github wiki https://github.com/3proxy/3proxy/wiki
|
||||||
|
|
||||||
@ -31,7 +31,7 @@ Documentation (man pages and HTML) available with download, on https://3proxy.or
|
|||||||
|
|
||||||
3 docker configurations are provided, default (full) also tagged as `:latest`, `:busybox` and `:minimal`, all refer to newest stable version. Except busybox, images are distroless and contain only binaries, you can not sh inside the container. `:busybox` contains busybox shell.
|
3 docker configurations are provided, default (full) also tagged as `:latest`, `:busybox` and `:minimal`, all refer to newest stable version. Except busybox, images are distroless and contain only binaries, you can not sh inside the container. `:busybox` contains busybox shell.
|
||||||
|
|
||||||
# Default image (`:latest`):
|
### Default image (`:latest`):
|
||||||
|
|
||||||
Full installation requires to mount /etc/3proxy directory with 3proxy.cfg files.
|
Full installation requires to mount /etc/3proxy directory with 3proxy.cfg files.
|
||||||
|
|
||||||
@ -52,10 +52,10 @@ docker run --read-only -p 3129:3129 -v /path/to/local/config/directory:/etc/3pro
|
|||||||
|
|
||||||
since 0.9.6 images are distroless (except :busybox) it's recommended to use with read only file system, there are no benefits from chroot. For compatibility, you still can use chroot installation by mounting directory with 3proxy.cfg to /usr/local/3proxy/config.
|
since 0.9.6 images are distroless (except :busybox) it's recommended to use with read only file system, there are no benefits from chroot. For compatibility, you still can use chroot installation by mounting directory with 3proxy.cfg to /usr/local/3proxy/config.
|
||||||
|
|
||||||
# Busybox image (`:busybox`):
|
### Busybox image (`:busybox`):
|
||||||
Full with busybox added, to allow shell commands inside container. All libraries are in /lib, so chroot configuration can not use plugins.
|
Full with busybox added, to allow shell commands inside container. All libraries are in /lib, so chroot configuration can not use plugins.
|
||||||
|
|
||||||
# Interactive `:minimal` image:
|
### Interactive `:minimal` image:
|
||||||
|
|
||||||
Dockerfile for "interactive" minimal 3proxy execution, no configuration mounting is required, configuration
|
Dockerfile for "interactive" minimal 3proxy execution, no configuration mounting is required, configuration
|
||||||
is accepted from stdin. Use `end` command to indicate the end of configuration. Use `log` for stdout logging.
|
is accepted from stdin. Use `end` command to indicate the end of configuration. Use `log` for stdout logging.
|
||||||
@ -83,8 +83,9 @@ Some proxy types (e.g. SOCKSv5 UDPASSCOC, SOCKSv5 BIND functionality, ftp proxy
|
|||||||
|
|
||||||
`:minimal` without version specified uses current stable version.
|
`:minimal` without version specified uses current stable version.
|
||||||
|
|
||||||
|
## Building and installation
|
||||||
|
|
||||||
## Windows Installation
|
### Windows Installation
|
||||||
|
|
||||||
Install and start proxy as Windows service:
|
Install and start proxy as Windows service:
|
||||||
|
|
||||||
@ -100,9 +101,9 @@ Remove the service (should be stopped before via `net stop 3proxy`):
|
|||||||
3proxy --remove
|
3proxy --remove
|
||||||
```
|
```
|
||||||
|
|
||||||
## Building and installation on Linux
|
### Building and installation on Linux
|
||||||
|
|
||||||
### With Makefile
|
#### With Makefile
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/z3apa3a/3proxy
|
git clone https://github.com/z3apa3a/3proxy
|
||||||
@ -112,9 +113,9 @@ make
|
|||||||
sudo make install
|
sudo make install
|
||||||
```
|
```
|
||||||
|
|
||||||
### Default Configuration (Linux/Unix)
|
#### Default Configuration (for Makefile.Linux installation)
|
||||||
|
|
||||||
3proxy uses 2 configuration files:
|
3proxy uses 2 configuration files in :
|
||||||
- `/etc/3proxy/3proxy.cfg` (before-chroot) - This configuration file is executed before chroot and should not be modified.
|
- `/etc/3proxy/3proxy.cfg` (before-chroot) - This configuration file is executed before chroot and should not be modified.
|
||||||
- `/usr/local/3proxy/conf/3proxy.cfg` symlinked from `/etc/3proxy/conf/3proxy.cfg` (after-chroot) - Main configuration file. Modify this file if required.
|
- `/usr/local/3proxy/conf/3proxy.cfg` symlinked from `/etc/3proxy/conf/3proxy.cfg` (after-chroot) - Main configuration file. Modify this file if required.
|
||||||
|
|
||||||
@ -124,7 +125,7 @@ Log files are created in `/usr/local/3proxy/logs` symlinked from `/var/log/3prox
|
|||||||
|
|
||||||
By default, socks is started on 0.0.0.0:1080 and proxy on 0.0.0.0:3128 with basic auth, no users are added by default.
|
By default, socks is started on 0.0.0.0:1080 and proxy on 0.0.0.0:3128 with basic auth, no users are added by default.
|
||||||
|
|
||||||
### Adding Users
|
#### Adding Users
|
||||||
|
|
||||||
Use `add3proxyuser` script to add users:
|
Use `add3proxyuser` script to add users:
|
||||||
|
|
||||||
@ -138,7 +139,7 @@ Parameters:
|
|||||||
|
|
||||||
Or modify `/etc/3proxy/conf/` files directly.
|
Or modify `/etc/3proxy/conf/` files directly.
|
||||||
|
|
||||||
### With CMake
|
#### With CMake
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/z3apa3a/3proxy
|
git clone https://github.com/z3apa3a/3proxy
|
||||||
@ -151,9 +152,9 @@ sudo cmake --install .
|
|||||||
|
|
||||||
CMake does not use chroot configuration, config file is `/etc/3proxy/3proxy.cfg`
|
CMake does not use chroot configuration, config file is `/etc/3proxy/3proxy.cfg`
|
||||||
|
|
||||||
## MacOS X / FreeBSD / *BSD
|
### MacOS X / FreeBSD / *BSD
|
||||||
|
|
||||||
### With Makefile
|
#### With Makefile
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/z3apa3a/3proxy
|
git clone https://github.com/z3apa3a/3proxy
|
||||||
@ -164,7 +165,7 @@ make
|
|||||||
|
|
||||||
Binaries are in `bin/` directory.
|
Binaries are in `bin/` directory.
|
||||||
|
|
||||||
### With CMake (recommended)
|
#### With CMake (recommended)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/z3apa3a/3proxy
|
git clone https://github.com/z3apa3a/3proxy
|
||||||
@ -182,7 +183,7 @@ This installs:
|
|||||||
- rc scripts to `rc.d` for BSD
|
- rc scripts to `rc.d` for BSD
|
||||||
- launchd plist to `/Library/LaunchDaemons/` for MacOS
|
- launchd plist to `/Library/LaunchDaemons/` for MacOS
|
||||||
|
|
||||||
### Service Management on macOS
|
#### Service Management on macOS
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Load and start service
|
# Load and start service
|
||||||
@ -322,32 +323,32 @@ sudo launchctl unload /Library/LaunchDaemons/org.3proxy.3proxy.plist
|
|||||||
### 3proxy
|
### 3proxy
|
||||||
Combined proxy server may be used as executable or service (supports installation and removal). It uses config file to read its configuration (see `3proxy.cfg.sample` for details). `3proxy.exe` is all-in-one, it doesn't require all others .exe to work. See `3proxy.cfg.sample` for examples, see `man 3proxy.cfg`
|
Combined proxy server may be used as executable or service (supports installation and removal). It uses config file to read its configuration (see `3proxy.cfg.sample` for details). `3proxy.exe` is all-in-one, it doesn't require all others .exe to work. See `3proxy.cfg.sample` for examples, see `man 3proxy.cfg`
|
||||||
|
|
||||||
### proxy
|
### 3proxy_proxy
|
||||||
HTTP proxy server, binds to port 3128
|
HTTP proxy server, binds to port 3128
|
||||||
|
|
||||||
### ftppr
|
### 3proxy_ftppr
|
||||||
FTP proxy server, binds to port 21. Please do not mess it with FTP over HTTP proxy used in browsers
|
FTP proxy server, binds to port 21. Please do not mess it with FTP over HTTP proxy used in browsers
|
||||||
|
|
||||||
### socks
|
### 3proxy_socks
|
||||||
SOCKS 4/5 proxy server, binds to port 1080
|
SOCKS 4/5 proxy server, binds to port 1080
|
||||||
|
|
||||||
### pop3p
|
### 3proxy_pop3p
|
||||||
POP3 proxy server, binds to port 110. You must specify POP3 username as `username@popserver[:port]` (port is 110 by default).
|
POP3 proxy server, binds to port 110. You must specify POP3 username as `username@popserver[:port]` (port is 110 by default).
|
||||||
|
|
||||||
Example: in Username configuration for your e-mail reader set `someuser@pop.somehost.ru`, to obtain mail for someuser from pop.somehost.ru via proxy.
|
Example: in Username configuration for your e-mail reader set `someuser@pop.somehost.ru`, to obtain mail for someuser from pop.somehost.ru via proxy.
|
||||||
|
|
||||||
### smtpp
|
### 3proxy_smtpp
|
||||||
SMTP proxy server, binds to port 25. You must specify SMTP username as `username@smtpserver[:port]` (port is 25 by default).
|
SMTP proxy server, binds to port 25. You must specify SMTP username as `username@smtpserver[:port]` (port is 25 by default).
|
||||||
|
|
||||||
Example: in Username configuration for your e-mail reader set `someuser@mail.somehost.ru`, to send mail as someuser via mail.somehost.ru via proxy.
|
Example: in Username configuration for your e-mail reader set `someuser@mail.somehost.ru`, to send mail as someuser via mail.somehost.ru via proxy.
|
||||||
|
|
||||||
### tcppm
|
### 3proxy_tcppm
|
||||||
TCP port mapping. Maps some TCP port on local machine to TCP port on remote host.
|
TCP port mapping. Maps some TCP port on local machine to TCP port on remote host.
|
||||||
|
|
||||||
### tlspr
|
### 3proxy_tlspr
|
||||||
TLS proxy (SNI proxy) - sniffs hostname from TLS handshake
|
TLS proxy (SNI proxy) - sniffs hostname from TLS handshake
|
||||||
|
|
||||||
### udppm
|
### 3proxy_udppm
|
||||||
UDP port mapping. Maps some UDP port on local machine to UDP port on remote machine. Only one user simultaneously can use UDP mapping, so it can't be used for public service in large networks. It's OK to use it to map to DNS server in small network or to map Counter-Strike server for single client (you can use few mappings on different ports for different clients in last case).
|
UDP port mapping. Maps some UDP port on local machine to UDP port on remote machine. Only one user simultaneously can use UDP mapping, so it can't be used for public service in large networks. It's OK to use it to map to DNS server in small network or to map Counter-Strike server for single client (you can use few mappings on different ports for different clients in last case).
|
||||||
|
|
||||||
### 3proxy_crypt
|
### 3proxy_crypt
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user