关于此项目

OpenWrt是一个用于嵌入式设备的GNU/Linux发行版，具有强大的扩展性。不同于其他许多用于路由器的发行版，OpenWrt是一个从零开始编写的、功能齐全的、容易修改的路由器操作系统。实际上，这意味着您能够使用您想要的功能而不加进其他的累赘，而支持这些功能工作的linux kernel又远比绝大多数发行版来得新。

配置

"uci"是"Unified Configuration Interface"(统一配置界面)的缩写,意在OpenWrt整个系统的配置集中化。

系统配置应容易，更直接且在此有文档描述，从而使你的生活更轻松！

（它是White Russian系列OpenWrt基于nvram的配置的后继改进。）

许多程序在系统某处拥有自己的配置文件，

比如/etc/network/interfaces, /etc/exports, /etc/dnsmasq.conf或者 /etc/samba/samba.conf，

有时它们还使用稍有不同的语法。

在OpenWrt中你无需为此烦恼，我们只需更改UCI配置文件！

你不需要为了某个更改起效而重启系统！参阅下文中的命令行实用工具以了解如何做到这点。

还有不要忘了官方程序包(official binaries)里包含了很多后台程序，但默认情况下并未启用！

比如cron后台程序默认并未激活，因而只编辑crontab并无作用。

你需要用/etc/init.d/crond start起动它或用/etc/init.d/crond enable激活它。 大部分后台程序都可以disable(禁用),stop(停止)和restart（重起）。 还有一些非UCI配置你可以参阅。

镜像文件生成器

映像生成器 是一个创建自定义固件的预编译环境，可以在现有固件的基础编辑创建镜像。

使用映像生成器的原因：

创建最小化镜像如去除WEB界面
软件包直接嵌入squashfs，减少目标平台的空间需求
配置文件直接嵌入squashfs作为预配置

本文章由 http://www.wifidog.pro/2015/07/09/openwrt%E7%AE%80%E4%BB%8B.html 整理编辑，转载请注明出处

X86 openWRT 虚拟机编译教程 在ubuntu10中X86 OpenWRT的源码编译

一、获取软件工具

获得各种工具软件的最新依赖关系包：

sudo apt-get update

直接拷贝下一命令，并执行安装所有要用到的工具软件

sudo apt-get -y install curl wget tree grep gcj texinfo sharutils subversion ncurses-term libtool autoconf automake gcc-multilib bison screen gcc g++ binutils patch bzip2 flex make gettext unzip libc6 git-core build-essential libncurses5-dev zlib1g-dev gawk quilt asciidoc libz-dev

二、获取openWRT源码

进入当前用户home目录，建立文件夹openwrt：

cd ~

mkdir openwrt

cd openwrt

如果你的网络速度较慢，不给力，我将下载好的openWRT（版本：r38938）打包成trunk.tar.gz，大家可以拷贝到本目录后直接解压 tar xvzf trunk.tar.gz即可，然后跳过如下几步，做openWRT配置。

使用svn命令行checkout出源代码：（版本：r38938）

svn checkout svn:svn.openwrt.org/openwrt/trunk –r38938 

本文章由 http://www.wifidog.pro/2015/07/07/ubuntu%E7%BC%96%E8%AF%91X86-openwrt.html 整理编辑，转载请注明出处

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 整理编辑，转载请注明出处

怎么把wifidog直接编译进openwrt,让生成的bin文件就带有wifidog，省得再去装ipk文件？

openwrt 根目录make menuconfig 搜索 Captive portal/ 看下有没有wifidog选项，如果没有

./scripts/feeds update -a
./scripts/feeds install -a
make menuconfig

还不行的话，在项目下终端：

vim feeds.conf.default

增加这一行：

src-git wifidog https://github.com/wifidog/wifidog-gateway.git

然后重新：

./scripts/feeds update -a
./scripts/feeds install -a

终端执行 make menuconfig, 在Network/captive portals/下选择wifidog 就有选择 WiFiDog 这一项了。

本文章由 http://www.wifidog.pro/2015/07/01/openwrt%E7%BC%96%E8%AF%91wifidog-1.html 整理编辑，转载请注明出处