本项目是 shadowsocksr-libev 在 OpenWrt 上的移植
各平台预编译IPK请在本项目releases页面下载
软件包包含 shadowsocksr-libev 的可执行文件,以及luci控制界面
支持SSR客户端、服务端模式（服务端支持部分混淆模式、支持多端口）
支持SOCK5代理；支持UDP中继；支持广告屏蔽
支持两种运行模式：IP路由模式和GFW列表模式（GFWList）
所有进程自动守护，崩溃后自动重启；支持服务器自动切换；
集成KcpTun加速，此功能对路由器性能要求较高，需下载对应的二进制文件到路由器指定目录，请酌情使用
客户端兼容运行SS或SSR的服务器，使用SS服务器时，传输协议需设置为origin，混淆插件需设置为plain
支持 ssr:// url格式导入和导出服务器配置信息
【IP路由模式】
- 所有国内IP网段不走代理，国外IP网段走代理；
- 白名单模式：缺省都走代理，列表中IP网段不走代理
优点：国内外分流清晰明确；适合线路好SSR服务器，通过代理可提高访问国外网站的速度；
缺点：开启BT下载时，如连接国外的IP，会损耗SSR服务器的流量；如果SSR服务器线路不好，通过代理访问国外网站的速度不如直连
【GFW列表模式】
- 只有在GFW列表中的网站走代理；其他都不走代理；
- 黑名单模式：缺省都不走代理，列表中网站走代理
优点：目标明确，只有访问列表中网站才会损耗SSR服务器流量
缺点：GFW列表并不能100%涵盖被墙站点，而且有些国外站点直连速度远不如走代理
注意：如果要使用SSR for OpenWRT的服务端接收手机的接入（通过3G/4G网络），请使用IP路由模式，原因是手机通过无线网络接入OpenWRT服务端，手机上如果要访问google，它使用的是手机上的DNS解析，域名解析是被污染的，指向的是一个随机IP，此IP不能和GFW列表匹配，因此如果使用GFW模式，将不能科学上网
如果在IP路由模式下代理正常，在GFW列表模式下无法正常访问，请检查DNS解析是否正确（服务器是否开启UDP转发、是否有其他dns软件冲突等）
-
从 OpenWrt 的 SDK 编译（编译环境：Ubuntu 64位系统），如果是第一次编译，还需下载OpenWrt所需依赖软件
sudo apt-get install gawk libncurses5-dev libz-dev zlib1g-dev git ccache
-
下载路由器对应平台的SDK
# 以 ar71xx 平台为例 tar xjf OpenWrt-SDK-15.05-ar71xx-generic_gcc-4.8-linaro_uClibc-0.9.33.2.Linux-x86_64.tar.bz2 cd OpenWrt-SDK-* # 安装 feeds ./scripts/feeds update packages ./scripts/feeds install libpcre # 获取 Makefile git clone https://github.com/ywb94/openwrt-ssr.git package/openwrt-ssr # 选择要编译的包 #luci ->3. Applications-> luci-app-shadowsocksR 原始版本 #luci ->3. Applications-> luci-app-shadowsocksR-GFW GFWList版本 #V1.1.6以后版本取消发布单独的客户端和服务端，如有需要，请修改makefile或采用V1.1.5版本 make menuconfig #如果没有安装po2lmo，则安装（可选） pushd package/openwrt-ssr/tools/po2lmo make && sudo make install popd #编译语言文件（可选） po2lmo ./package/openwrt-ssr/files/luci/i18n/shadowsocksr.zh-cn.po ./package/openwrt-ssr/files/luci/i18n/shadowsocksr.zh-cn.lmo # 开始编译 make package/openwrt-ssr/compile V=99
-
LEDE编译补充
LEDE是OpenWRT的另一个版本，LEDE的SDK采用xz压缩，需先用xz -d解压下载的SDK包，再按上述命令操作
使用LEDE的SDK编译，可能会提示找不到zlib和openssl文件，请运行如下命令
./scripts/feeds update #如果更新base出现错误，修改SDK目录下的feeds.conf.default文件，将“source.git;HEAD”改为“source.git” ./scripts/feeds install zlib ./scripts/feeds install libopenssl -
Pandorabox(潘多拉)编译补充
潘多拉也是Openwrt的另一个定制版本，用16.10版本的SDK编译时无法使用feed获取安装包，需要先将libpcre、zlib、libopenssl等makefile放入SDK的package目录，再make menuconfig
这三个包的makefile可以从这里下载
本软件包依赖库：libopenssl、libpthread、ipset、ip、iptables-mod-tproxy、libpcre，GFW版本还需依赖dnsmasq-full、coreutils-base64，opkg会自动安装上述库文件
软件编译后可生成两个软件包，分别是luci-app-shadowsocksR（原始版本）、luci-app-shadowsocksR-GFW（GFW版本），用户根据需要选择其中一个安装即可
原始版本只支持IP路由模式，对现有OpenWRT系统改动较少；本地dns域名解析存在污染，由远端SSR服务器重新进行二次DNS解析；可和其他DNS处理软件一起使用；
GFW版本支持IP路由模式和GFW列表模式，需卸载原有的dnsmasq，会接管OpenWRT的域名处理，避免域名污染并实现准确分流；SSR服务器侧需开启UDP转发；
提醒：如果安装GFW版本，请停用当前针对域名污染的其他处理软件，不要占用UDP 5353端口
将编译成功的luci-app-shadowsocksR*_all.ipk通过winscp上传到路由器的/tmp目录，执行命令：
#刷新opkg列表
opkg update
#删除dnsmasq（GFW版本第一次安装需手动卸载dnsmasq，其他情况下不需要）
opkg remove dnsmasq
#安装软件包
opkg install /tmp/luci-app-shadowsocksR*_all.ipk 如要启用KcpTun，需从本项目releases页面或相关网站（网站1、网站2）下载路由器平台对应的二进制文件，并将文件名改为ssr-kcptun，放入/usr/bin目录
安装后强烈建议重启路由器，因为luci有缓存机制，在升级或新装IPK后，如不重启有时会出现一些莫名其妙的问题；另GFW版本会安装、修改、调用dnsmasq-full，安装后最好能重启路由器
软件包通过luci配置， 支持的配置项如下:
客户端服务器配置：
| 键名 | 数据类型 | 说明 |
|---|---|---|
| auth_enable | 布尔型 | 一次验证开关[0.关闭 1.开启],需要服务端同时支持 |
| switch_enable | 布尔型 | 此服务器是否可以自动切换 |
| server | 主机类型 | 服务器地址, 可以是 IP 或者域名，推荐使用IP地址 |
| server_port | 数值 | 服务器端口号, 小于 65535 |
| local_port | 数值 | 本地绑定的端口号, 小于 65535 |
| timeout | 数值 | 超时时间（秒）, 默认 60 |
| password | 字符串 | 服务端设置的密码 |
| encrypt_method | 字符串 | 加密方式, 详情参考 |
| protocol | 字符串 | 传输协议，默认"origin"详情参考 |
| protocol_param | 字符串 | 传输协议插件参数(可选) |
| obfs | 字符串 | 混淆插件，默认"plain" 详情参考 |
| obfs_param | 字符串 | 混淆插件参数 详情参考 |
| fast_open | 布尔型 | TCP快速打开 详情参考 |
| kcp_enable | 布尔型 | KcpTun开启开关 |
| kcp_port | 数值 | KcpTun服务器端口号, 小于 65535 |
| kcp_password | 字符串 | KcpTun密码，留空表示"it's a secrect" |
| kcp_param | 字符串 | KcpTun参数详情参考 |
客户端其他配置：
| 名称 | 含义 |
|---|---|
| 全局服务器 | 选择要连接的SSR TCP代理服务器 |
| UDP中继服务器 | 选择要连接的SSR UDP代理服务器 |
| 启用进程监控 | 启用后可对所有进程进行监控，发现崩溃自动重启 |
| 启用自动切换 | 启用后如果缺省代理服务器失效，可以自动切换到其他可用的代理服务器 |
| 自动切换检查周期 | 检查当前代理服务器是否有效的时间周期，默认10分钟（600秒） |
| 切换检查超时时间 | 检查服务器端口或网络连通性的超时时间，默认3秒钟 |
| DNS解析方式 | 用UDP隧道方式还是Pdnsd方式（TCP）来解析域名（GFW版本特有，安装pdnsd后显示） |
| 启用隧道（DNS）转发 | 开启DNS隧道（原始版本特有） |
| 隧道（DNS）本地端口 | DNS隧道本地端口（原始版本特有，GFW固定为5353） |
| DNS服务器地址和端口 | DNS请求转发的服务器，一般设置为google的dns地址 |
| SOCKS5代理-服务器 | 用于SOCKS代理的SSR服务器 |
| SOCKS5代理-本地端口 | 用于SOCKS代理的本地端口（注意此端口不能和SSR服务器配置中的本地端口相同） |
| 访问控制-被忽略IP列表 | IP路由模式时有效，用于指定存放国内IP网段的文件，这些网段不经过代理 |
| 访问控制-额外被忽略IP | IP路由模式时有效，用于添加额外的不经过代理的目的IP地址 |
| 访问控制-强制走代理IP | 用于添加需要经过代理的目的IP地址 |
| 路由器访问控制 | 用于控制路由器本身是否走代理，适用于路由器挂载BT下载的情况 |
| 内网访问控制 | 可以控制内网中哪些IP能走代理，哪些不能走代理，可以指定下面列表内或列表外IP |
| 内网主机列表 | 内网IP列表，可以指定多个 |
服务端配置：
| 键名 | 数据类型 | 说明 |
|---|---|---|
| enable | 布尔型 | 是否启用此服务器配置 |
| server | 字符串 | 服务器本机IP地址, 一般为0.0.0.0 |
| server_port | 数值 | 服务器监听端口号, 小于 65535 |
| timeout | 数值 | 超时时间（秒）, 默认 60 |
| password | 字符串 | 服务端设置的密码 |
| encrypt_method | 字符串 | 加密方式, 详情参考 |
| protocol | 字符串 | 传输协议，默认"origin"详情参考 |
| obfs | 字符串 | 混淆插件，默认"plain" 详情参考 |
| obfs_param | 字符串 | 混淆插件参数 详情参考 |
| fast_open | 布尔型 | TCP快速打开 详情参考 |
在某些openwrt上的kcptun启用压缩后存在问题，因此在界面上加上了“--nocomp”参数，缺省为非压缩，请在服务端也使用非压缩模式
如要打开kcptun的日志，可以在kcptun参数栏填入"--nocomp --log /var/log/kcptun.log"，日志会保存在指定文件中
IP路由模式的数据文件为/etc/china_ssr.txt,包含国内所有IP网段，一般很少变动，无需更新，如要更新，请在“状态”页面更新
GFW列表模式的数据文件为/etc/dnsmasq.ssr/gfw_list.conf，包含所有被墙网站，如需更新，请在“状态”页面更新
如果要自定义GFW规则，在目录/etc/dnsmasq.ssr下创建一个文件，名称任取，比如myrules.conf，在文件中按要求输入你需要添加的网址，比如要添加google.com.hk，需输入如下两行：
server=/.google.com.hk/127.0.0.1#5353
ipset=/.google.com.hk/gfwlist
添加后执行/etc/init.d/dnsmasq restart重启dnsmasq
广告过滤为GFW版本特有，数据文件为/etc/dnsmasq.ssr/ad.conf，其原理是将广告网站的IP地址解析为127.0.0.1，使用的数据库为easylistchina+easylist；广告过滤模块缺省未安装，用户在“状态”页面更新广告数据库后自动打开，如打开广告过滤后出现问题，请删除此文件并重启dnsmasq
自动切换说明：在服务器配置中如果某些服务器启用了自动切换开关，这些服务器就组成一个可以自动切换的服务器集合，当这些服务器中的某一个作为全局服务器使用，并打开了全局自动切换开关时，如果全局服务器故障，会自动在集合中寻找可用的服务器进行切换。你可以设置检测周期和超时时间。每次检测时会判断缺省服务器是否恢复正常，如果正常，会自动切换回缺省服务器。注：自动切换功能依赖路由器的检测，因此在“路由器访问控制”中应该设置为“正常代理”
自动切换和进程监控的日志可以在OpenWRT的“系统日志”中查看
GFW版本缺省使用DNS隧道（UDP）方式解析域名，要求SS/SSR服务器支持UDP转发。如果服务器不支持UDP转发或UDP方式的解析存在问题，可以使用Pdnsd，以TCP方式来进行DNS域名解析。用户需自行安装pdnsd，安装后会在客户端界面出现“DNS解析方式”选择项，可以选择“使用pdnsd方式”来解析，pdnsd缺省用TCP模式解析，用户可以设置DNS服务器地址和端口，设置的DNS服务器需支持TCP方式查询
官方新版本中已经取消了pdnsd的下载，如要下载，请在14.07版本中查找，如ar71xx的下载地址为： http://downloads.openwrt.org/barrier_breaker/14.07/ar71xx/generic/packages/oldpackages/pdnsd_1.2.9a-par-a8e46ccba7b0fa2230d6c42ab6dcd92926f6c21d_ar71xx.ipk
官方openssl的ipk在编译时去除了camellia和idea加密算法，如果使用官方的libopenssl，将无法使用这两种加密方式，如需使用，请重新编译openssl进行替换
请点击本页面上的“Issues”反馈使用问题或建议
客户端：
服务端：
状态页面：
