WifiDog 是一款开源的用来实现无线认证的软件，可以集成到路由器或者网关中，对于连接到路由器或者网关的设备，使其先登录云端认证服务器，然后通过认证才能上网。比如在星巴克上网，浏览器会先弹出一个广告页面，我们输入手机号，获取验证码，然后就可以上网了。

网关心跳（Ping协议）

Wifidog将ping协议做为心跳机制向认证服务器发送当前状态信息。这可以实现为认证服务器每个节点的状态生成中央日志。

Wifidog客户端在conf文件中进行设置，目的是通过http定期启动thread(ping_thread.c)向认证服务器发送状态信息。信息格式如下：

http://auth_sever/ping/?    
gw_id=%s
sys_uptime=%lu    
sys_memfree=%u    
sys_load=%.2f    
wifidog_uptime=%lu

通过系统调用wifidog客户端收集的数据

Headers
HTTP/1.0\r\n" 
"User-Agent: WiFiDog %s\r\n" 
"Host: %s\r\n" 
"\r\n",

一个标准的HTTP需求应该是：

GET /ping/?gw_id=001217DA42D2&sys_uptime=742725&sys_memfree=2604&sys_load=0.03&wifidog_uptime=3861 HTTP/1.0
User-Agent: WiFiDog 1.1.3_beta6
Host: www.wifidog.pro

认证服务器认证协议

这个页面描述了当用户已经被认证并允许访问互联网时，为了认证用户和进程，wifidog网关和认证服务器之间的信息传送。

Wifidog客户端将定期的启动一个thread来报告每个用户的连接状况。目前它被用来报告每个用户输入/输出计数器，以显示用户依然在现，并允许认证服务器将不再连接的用户断开。
以下是发给每个在线用户的信息

auth_server:/auth/index.php?
stage=
ip=
mac=
token=
incoming=
outgoing=

注意：stage=计数器/登录，取决于是否是新客户端
即使输入输出变量会在所有信息中出现，但他们只对处于counter阶段的信息有效。其它情况下输入输出经常设置为0。
在做回复时，认证服务器会以有效身份或新用户信息，或者认证服务器错误提示形式进行回复。
回复格式如下：
Auth:

新用户状态为：

0 - AUTH_DENIED - User firewall users are deleted and the user removed.
6 - AUTH_VALIDATION_FAILED - User email validation timeout has occured and user/firewall is deleted
1 - AUTH_ALLOWED - User was valid, add firewall rules if not present
5 - AUTH_VALIDATION - Permit user access to email to get validation email under default rules
-1 - AUTH_ERROR - An error occurred during the validation process

注意：认识服务器错误一般不会改变防火墙或用户状态

标准的URL为：

GET /auth/?stage=counters&ip=7.0.0.107&mac=00:40:05:5F:44:43&token=4f473ae3ddc5c1c2165f7a0973c57a98&incoming=6031353&outgoing=827770 HTTP/1.0
User-Agent: WiFiDog 1.1.3_beta6
Host: www.wifidog.pro

网关重定向浏览器

客户端浏览器在不同情况下会被重定向到其它页面：

初始化请求：

基于捕捉，客户端会被网关重定向到以下URL：

login/?gw_address=%s&gw_port=%d&gw_id=%s&url=%s 
例如：https://www.wifidog.pro/login/?gw_id=0016B6DA9AE0&gw_address=7.0.0.1&gw_port=2060

初始化请求之后

当请求被处理并且客户端已经被重定向到网关时

如果服务器回复AUTH_DENIED：注意你通常在标准认证服务器上看不到这样的提示。客户端将不会被重定向回网关。

gw_message.php?message=denied

如果服务器回复AUTH_VALIDATION:

gw_message.php?message=activate

如果服务器回复AUTH_ALLOWED:这是门户重定向：

portal/?gw_id=%s

如果服务器回复AUTH_VALIDATION_FAILED:注意你将不会在标准认证服务器看到此回复。客户端将不会重定向回网关。

gw_message.php?message=failed_validation

认证服务器重定向浏览器

基于成功登录，客户端将被重定向到网关。

http://" . $gw_address . ":" . $gw_port . "/wifidog/auth?token=" . $token

URL示例：http://192.168.1.1:2060/wifidog/auth?token=4f473ae3ddc5c1c2165f7a0973c57a98

本文章由 http://www.wifidog.pro/2015/07/05/wifidog%E8%AE%A4%E8%AF%81-6.html 整理编辑，转载请注明出处

Feeds是OpenWrt环境所需要的软件包套件。最重要的feeds有：

‘packages’一些额外的基础路由器特性软件

‘LuCI’OpenWrt默认的GUI

‘Xwrt’另一种可选的GUI界面

需要能够连接互联网。

在下载之前可以通过查看’feeds.conf.default’文件，来检查哪些文件需要包含在环境中。

开始下载，使用：

[openwrt@localhost trunk]$ ./scripts/feeds update -a

安装feeds包，只有安装之后，在后面的make menuconfig时，才可以对相关配置进行勾选。

[openwrt@localhost trunk]$ ./scripts/feeds install -a

如果更新了feeds的配置文件，需要添加新的软件包用于生成系统。只需进行重复操作：

[openwrt@localhost trunk]$ ./scripts/feeds update -a

[openwrt@localhost trunk]$ ./scripts/feeds install -a

可使用的feeds列表配置在feeds.conf目录下或者feeds.conf.default。这个文件包含了feeds列表，每一行又三部分组成，feed方法，feed 名字和feed源

下面是一个feeds.conf.default的例子：

src-git packages https://github.com/openwrt/packages.git
src-git luci http://git.openwrt.org/project/luci.git
src-git routing https://github.com/openwrt-routing/packages.git
src-git telephony http://git.openwrt.org/feed/telephony.git
src-git management https://github.com/openwrt-management/packages.git
src-git oldpackages http://git.openwrt.org/packages.git
#src-svn xwrt http://x-wrt.googlecode.com/svn/trunk/package
#src-svn phone svn://svn.openwrt.org/openwrt/feeds/phone
#src-svn efl svn://svn.openwrt.org/openwrt/feeds/efl
#src-svn xorg svn://svn.openwrt.org/openwrt/feeds/xorg
#src-svn desktop svn://svn.openwrt.org/openwrt/feeds/desktop
#src-svn xfce svn://svn.openwrt.org/openwrt/feeds/xfce
#src-svn lxde svn://svn.openwrt.org/openwrt/feeds/lxde
#src-link custom /usr/src/openwrt/custom-feed

下面是feed支持的方法类型：

src-bzr 通过使用bzr从数据源的path/URL下载数据

src-cpy 通过从数据源path拷贝数据

src-darcs 通过使用darcs从数据源path/URL下载数据

src-git 通过使用git从数据源path/URL下载数据

src-hg 通过使用hg从数据源path/URL 下载数据

src-link 创建一个数据源path的symlink

src-svn 通过使用svn从数据源path/URL下载数据

本文章由 http://www.wifidog.pro/2015/06/24/openwrt-feed-%E5%88%86%E6%9E%90.html 整理编辑，转载请注明出处

需求场景

有一个免认证的 Wifi SSID，比如叫：OpenWrt，附近的同学可以随便连上这个 SSID，没有缴过费的同学不管访问什么地址，都会被跳转到收费提醒页面，而缴过费的同学就可以开心上网了。

解决办法

从需求上来说，这是一个非常标准的 WifiDog 效果，如果未来有很复杂的需求，可以直接通过 WifiDog 来实现跳转，然后再通过 AuthPuppy 来实现账户管理，不过想在 OpenWrt 上同时部署 WifiDog 与 AuthPuppy 也不是一件很容易的事情。

因此我们准备考虑直接通过 iptables 来实现这个需求，未来如果有复杂的扩展需求，也不影响扩展到 WifiDog 来实现。

实现流程

通过 SSH 登录到 OpenWrt，打开 /etc/config/uhttpd，在文件的最顶部增加以下配置

config uhttpd 'portal'
list listen_http '0.0.0.0:11990'
option home '/www/portal'
option error_page '/index.html'

然后在 /www/portal 下新建一个名为 index.html 的静态文件，文件内容可以如下

<html>
<head>
  <meta http-equiv="cache-control" content="no-cache">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Wifi</title>
</head>
<body>
  Email: xxxx@xxx.com
</bodu>
</html>

之后再打开 /etc/firewall.user 文件，在末尾添加如下配置：

iptables -t nat -A prerouting_lan_rule -p tcp -m tcp --dport 80 -m mark ! --mark 8 -j REDIRECT --to-ports 11990
iptables -t filter -A forwarding_lan_rule -m mark ! --mark 8 -j REJECT

保存后执行 /etc/init.d/firewall restart 重新载入 iptables 的配置
然后再执行 /etc/init.d/uhttpd restart 重新载入 uhttpd 的配置

然后用手机连接这个无线网络，你就会发现总是弹出这个提示页面了

用户授权

当有用户缴费了之后，向他要到他的MAC地址，同样打开 /etc/firewall.user 文件，比如这个用户有 2 个设备，MAC 地址分别是 00:00:00:00:BB:AA 与 00:00:00:00:BB:BB 则添加以下 2 条 规则，以后这 2 个设备就可以随便上网了！

iptables -t mangle -A fwmark -m mac --mac-source 00:00:00:00:BB:AA -j MARK --set-mark 8
iptables -t mangle -A fwmark -m mac --mac-source 00:00:00:00:BB:BB -j MARK --set-mark 8

添加后同样需要执行 /etc/init.d/firewall restart 以使配置生效

注意事项

如果通过以太网口访问 OpenWrt luci 管理界面也是那个收费提示，只需要把该机器的 MAC 地址同样授权一样即可

本文章由 http://www.wifidog.pro/2015/04/08/openwrt-wifidog-5.html 整理编辑，转载请注明出处

wifidog

WifiDog是路由器的一种上网认证功能，如果开启此功能，所有通过路由器上网的设备都会跳转到指定的界面，需要通过某种方式认证才可以上网，这种认证方式的优势在于安全性高，不容易被破解验证。

WifiDog安装
登录到 OpenWrt luci 后台，打开 System / Software，然后查找 wifidog

再点击 Available packages (wifidog)，选择安装

WifiDog 安装后，还需要到 System / Startup 使用 WifiDog 服务自动启动

然后还要到 Network /Firewall 里，把 lan => wan 的默认 Forward 规则改为 reject

wiwiz 账号申请

Wifidog 使用时需要配合认证系统来使用，你可以部署一个 AuthPuppy，不过如果为了测试方便，可以直接申请一个 wiwiz 的账号。Wiwiz是一个有线/无线网络热点管理系统，利用它你可以为你的热点创建一个强制门户/强制认证页面（captive portal）。

申请好账号之后，需要在 Wiwiz 里创建一个热点，这个时候将得到你的 HotSpot ID，把这个 ID 记录下来，等下 WifiDog 配置的时候要用到。

WifiDog配置

使用 SSH 登录到你的 OpenWrt 上，编辑 /etc/wifidog.conf 文件，在文件末尾增加以下配置：

GatewayID 14BBB888BBB
AuthServer {
    Hostname cp.wiwiz.com
    Path /as/s/
}

最后直接重新启动一下路由器，然后用你的终端通过你的路由器访问互联网，就会弹出 Wiwiz 的认证页面

本文章由 http://www.wifidog.pro/2015/04/08/wifidog-openwrt-2.html 整理编辑，转载请注明出处