mirror of
https://github.com/shadowsocks/shadowsocks-rust.git
synced 2026-11-06 16:14:11 +00:00
Linus Färnstrand
afff1982aa
* Remove unused addr field in Plugin struct * Replace many Option matches with Option::map and and_then * Rustfmt run * Various changes suggested by clippy
128 lines
3.2 KiB
Rust
128 lines
3.2 KiB
Rust
//! shadowsocks is a fast tunnel proxy that helps you bypass firewalls.
|
|
//!
|
|
//! Currently it supports SOCKS5 and HTTP Proxy protocol.
|
|
//!
|
|
//! ## Usage
|
|
//!
|
|
//! Build shadowsocks and you will get at least 2 binaries: `sslocal` and `ssserver`
|
|
//!
|
|
//! Write your servers in a configuration file. Format is defined in
|
|
//! [shadowsocks' documentation](https://github.com/shadowsocks/shadowsocks/wiki)
|
|
//!
|
|
//! For example:
|
|
//!
|
|
//! ```json
|
|
//! {
|
|
//! "server": "my_server_ip",
|
|
//! "server_port": 8388,
|
|
//! "local_address": "127.0.0.1",
|
|
//! "local_port": 1080,
|
|
//! "password": "mypassword",
|
|
//! "timeout": 300,
|
|
//! "method": "aes-256-cfb"
|
|
//! }
|
|
//! ```
|
|
//!
|
|
//! Save it in file `shadowsocks.json` and run local proxy server with
|
|
//!
|
|
//! ```bash
|
|
//! cargo run --bin sslocal -- -c shadowsocks.json
|
|
//! ```
|
|
//!
|
|
//! Now you can use SOCKS5 protocol to proxy your requests, for example:
|
|
//!
|
|
//! ```bash
|
|
//! curl --socks5-hostname 127.0.0.1:1080 https://www.google.com
|
|
//! ```
|
|
//!
|
|
//! On the server side, you can run the server with
|
|
//!
|
|
//! ```bash
|
|
//! cargo run --bin ssserver -- -c shadowsocks.json
|
|
//! ```
|
|
//!
|
|
//! Server should use the same configuration file as local, except the listen addresses for servers must be socket
|
|
//! addresses.
|
|
//!
|
|
//! Of course, you can also use `cargo install` to install binaries.
|
|
//!
|
|
//! ## API Usage
|
|
//!
|
|
//! Example to write a local server
|
|
//!
|
|
//! ```no_run
|
|
//! use shadowsocks::{run_local, Config, ConfigType};
|
|
//!
|
|
//! let config = Config::load_from_file("shadowsocks.json", ConfigType::Local).unwrap();
|
|
//! run_local(config);
|
|
//! ```
|
|
//!
|
|
//! That's all! And let me show you how to run a proxy server
|
|
//!
|
|
//! ```no_run
|
|
//! use shadowsocks::{run_server, Config, ConfigType};
|
|
//!
|
|
//! let config = Config::load_from_file("shadowsocks.json", ConfigType::Server).unwrap();
|
|
//! run_server(config);
|
|
//! ```
|
|
|
|
#![crate_type = "lib"]
|
|
#![crate_name = "shadowsocks"]
|
|
#![recursion_limit = "128"]
|
|
|
|
extern crate base64;
|
|
extern crate byte_string;
|
|
extern crate byteorder;
|
|
extern crate bytes;
|
|
extern crate digest;
|
|
#[macro_use]
|
|
extern crate futures;
|
|
extern crate libc;
|
|
#[cfg(feature = "sodium")]
|
|
extern crate libsodium_ffi;
|
|
#[macro_use]
|
|
extern crate log;
|
|
extern crate json5;
|
|
extern crate md5;
|
|
#[cfg(feature = "miscreant")]
|
|
extern crate miscreant;
|
|
extern crate openssl;
|
|
extern crate rand;
|
|
extern crate ring;
|
|
extern crate serde_urlencoded;
|
|
#[macro_use]
|
|
extern crate serde_derive;
|
|
extern crate serde;
|
|
extern crate subprocess;
|
|
#[macro_use]
|
|
extern crate tokio_io;
|
|
extern crate dns_parser;
|
|
extern crate lru_cache;
|
|
extern crate spin;
|
|
extern crate tokio;
|
|
#[cfg(any(unix, windows))]
|
|
extern crate tokio_signal;
|
|
extern crate trust_dns_resolver;
|
|
extern crate typenum;
|
|
extern crate url;
|
|
|
|
/// ShadowSocks version
|
|
pub const VERSION: &str = env!("CARGO_PKG_VERSION");
|
|
|
|
pub use self::{
|
|
config::{ClientConfig, Config, ConfigType, Mode, ServerAddr, ServerConfig},
|
|
relay::{
|
|
dns::run as run_dns,
|
|
local::{run as run_local, run_opt as run_local_opt, Options as LocalOptions},
|
|
server::{run as run_server, run_opt as run_server_opt, Options as ServerOptions},
|
|
tcprelay::client::Socks5Client,
|
|
},
|
|
};
|
|
|
|
pub mod config;
|
|
mod context;
|
|
pub mod crypto;
|
|
mod monitor;
|
|
pub mod plugin;
|
|
pub mod relay;
|