2015年3月

wifidog 用户第一次访问网络流程图-wifidog原理

通过wifidog实现用户上网强制认证后,用户第一次访问网络的流程大致如下:

1.用户通过浏览器访问某一网页。
2.wifidog重定向用户请求到认证服务器。
3.认证服务器返回登录认证页面给用户。
4.用户输入认证信息并提交。
5.认证通过后,服务器告知路由器放行。
6.用正常上网。

对应流程图如下:
QQ截图20150319091336.png

本文章由 http://www.wifidog.pro/2015/03/19/wifidog%E5%8E%9F%E7%90%86-1.html整理编辑,转载请注明出处

wifidog安装指南HotSpot Builder Utility安装指南 用于安装到Linux系统的计算机

1. 系统需求
硬件

  • 一台带有2个网络接口的计算机
  • 一个无线AP设备(如,无线路由器)

软件

  • Linux操作系统 (推荐ubuntu 8.04或更高)
  • dhcp3-server

如果dhcp3-server还没有安装,你可以手动安装,例如,
在Debian中执行:

sudo apt-get install dhcp3-server 

在Redhat/CentOS中执行:

yum install dhcp

将计算机的一个网络接口连接到Internet。
设置并启用无线网络,即用无线路由器创建一个可用Access Point。
将另一个网络接口(有线的或无线的)连接到(或桥接到)你的无线AP设备以接入无线局域网(WLAN),并且手动设置一个IP。

建议清空iptables/防火墙设置。例如:

/etc/init.d/iptables stop

iptables -t nat -F
iptables -t filter -F
iptables -t mangle -F

注:
当所有的安装设置完成后,你的计算机(而不是无线AP)将充当无线网络的网关的角色。所以,如果你的无线AP设备是一个无线路由器,那么请禁用它的DHCP与UPNP服务。

2. 在Web控制面板中创建热点
登录到Web控制面板,访问http://cp.wiwiz.com/as/
点击“我的热点”,在接下来的页面中点击“创建热点”。根据页面的提示完成各项设置,点击保存。
你将会看到你刚创建热点的Hotspot ID。记下它,接下来的步骤将会用到它。

3. 安装与设置Wiwiz HotSpot Builder Utility组件
http://www.wiwiz.com/download/下载最新版的Wiwiz HotSpot Builder Utility。

执行以下命令进行安装:

cd / ; tar -zxf hsbuilder-util-latest.tar.gz

执行以下命令以开始设置:

/usr/local/hsbuilder/hsbuilder_setup.sh setup

然后根据提示完成设置。
然后根据各步提示完成设置。以下是各步提示的说明:

“please select External NIC (typically the one going out to the Inernet):”– 此步请选择接入到Internet的网络接口。

“please select Internal NIC (typically your wifi interface):”– 此步请选择接入到局域网/无线局域网的网络接口。

“please input Hotspot ID:” — 此步请输入你在Wiwiz Web面板中创建的热点的Hotspot ID(不是热点的名称,也不是你的无线网络的SSID)。

“please input User Name:” — 此步请输入你的Wiwiz注册用户名。

“please input Server Address and Port:” — 此步请保持默认值。

“Do you want DHCP service to be configured? If you select No to skip it, you need to configure DHCP service manually later.” — 此步请选择是否让Wiwiz HotSpot Builder Utility自动配置DHCP服务。如果选择是,请继续以下的步骤。

“DHCP Setting: please input Network IP:” — 此步请输入你的局域网/无线局域网的网络IP。例如:192.168.1.0代表的是192.168.1.xxx网段。

“DHCP Setting: please input NET MASK:” — 此步请输入你的局域网/无线局域网的掩码。

“DHCP Setting: please input IP of Gateway (it should be the IP of this machine):” — 此步请输入今后的局域网/无线局域网的网关地址,即这台计算机的Internal NIC的IP地址(一般保留默认值即可)。

“DHCP Setting: please input DNS:” — 此步请输入DNS地址。默认值为程序自动检测到的DNS地址。也可以指定其他可用的DNS地址,推荐指定ISP提供的DNS地址。

“DHCP Setting: please input IP Range of this Network:” — 此步请输入DHCP地址分配范围。一般保留默认值即可。

最后,如果没有报错信息并看到“HSBuilder Setup Completed!”的提示文字,那么安装已经完成了。

注:
当上述过程完成后,如果程序提示警告信息“Warning: DHCP Service starting failed. You need to start it up manually.”,那么说明自动配置和启动DHCP服务失败,请自行手动配置并启动它。

你可以使用一个Wi-Fi客户端(如带WLAN适配器的PC或者支持Wi-Fi的移动电话)测试一下你的热点:

  • 搜索可用Wi-Fi热点,并连接到你的热点。
  • 打开Web浏览器,输入任何一个HTTP开头的网址。如果你的热点的认证页面能够显示出来,就说明你的热点已经正常运转了。

本文章由 http://www.wifidog.pro/2015/03/18/wifidog%E5%AE%89%E8%A3%85%E5%88%B0linux%E8%AE%A1%E7%AE%97%E6%9C%BA.html整理编辑,转载请注明出处

wifidog安装指南HotSpot Builder Utility安装指南

此处以VirtualBox举一个例子。建议你从http://www.wiwiz.com/zh/download/下载并使用我们提供的虚拟机镜像。它包含了所有必要的软件包,并且被很好的配置了,这样可以节约你很多时间。

系统需求

硬件

  • 一台带有1个以太网卡的电脑(宿主机)
  • 一个无线路由器

软件

准备工作

  1. 准备一个无线路由器,连接并设置好Internet连接,设置好无线局域网。
  2. 用网线连接电脑的网卡与无线路由器的LAN口。
  3. 把电脑网卡设置为静态IP,而不要用自动获得IP的方式,并确保电脑可以正常访问Internet。
  4. 关闭路由器的DHCP服务,确保网络中没有其他的DHCP服务运行(重要)。
  5. 建议关闭宿主机的防火墙。

安装与设置
1. 启动VirtualBox,导入我们的虚拟机镜像文件Wiwiz-VBox.ova,参考下图:
wiwizvbox-cn01.jpg

wiwizvbox-cn02.jpg

wiwizvbox-cn03.jpg

2. 导入后,会显示以下界面。然后,点击“设置”。
wiwizvbox-cn04.jpg

3. 确认网络设置。确保“网卡1”的连接方式必须是“桥接网卡”。如果电脑有多块网卡,那么,“界面名称”项务必要选择用网线连接路由器的网卡(重要)。网卡2、网卡3、网卡4的设置不要修改。
wiwizvbox-cn05.jpg

4. 然后,点击“启动”,运行虚拟机。
wiwizvbox-cn06.jpg

之后,你会看到以下的虚拟机运行界面:
wiwizvbox-cn07.jpg

稍等片刻后,待系统启动完毕,按一下回车键,就会进入到命令行界面,如下图。
wiwizvbox-cn08.jpg

5. 设置IP地址。输入以下命令:
setIP 192.168.1.9

注意:setIP命令后面的参数值是要给虚拟机设置的内网IP地址,它应和你的路由器内网网段是一致的,并且是一个没被占用的IP地址。例如,如果你的路由器网段是192.168.1.x,那么,IP可以是192.168.1.9。
wiwizvbox-cn09.jpg

6. 测试网络,确保在虚拟机内可以ping通路由器和外网地址(重要)。比如:
ping 192.168.1.1 #请将192.168.1.1替换为你的路由器的实际IP地址
ping baidu.com
如都能ping通,那么继续下一步,否则,请仔细检查确认之前的操作步骤。

7. 执行以下命令:
/usr/local/hsbuilder/hsbuilder_setup4openwrt.sh setup
然后,按照提示输入HotSpot ID和你的Wiwiz用户名,其他的项目都按回车即可。
如果你还没有Wiwiz用户名或HotSpot ID,那么请访问Wiwiz Web面板(http://cp.wiwiz.com)注册一个账户,登陆并创建一个热点即可得到HotSpot ID。
wiwizvbox-cn10.jpg

之后,等待片刻,如果没有报错信息并看到“HSBuilder Setup Completed!”的提示文字,那么安装就完成了。

最后,你可以使用一个WiFi终端设备(如带WLAN适配器的PC或者支持Wi-Fi的移动电话)测试一下你的热点:

  • 搜索并连接到你的热点。
  • 打开Web浏览器,输入任何一个HTTP开头的网址。如果你的热点的认证页面能够显示出来,就说明你的热点已经正常运转了。

常见问题:
1. 安装设置后,在WiFi终端设备里可以正常打开各网站页面,但是并不能显示认证页面。
解决方法:关闭路由器的DHCP服务,确保网络中没有其他的DHCP服务运行。然后,重启虚拟机。

2. 出现“Error Code: 4”的报错信息。
解决方法:确保在虚拟机内可以访问(ping通)路由器和外网地址。建议关闭宿主机的防火墙,并确保使用官方版本的VirtualBox程序,且安装正常。

3. VirtualBox的虚拟机的网络设置中,网卡1的“界面名称”项目里找不到需要桥接的有线网卡。
解决方法:确保宿主机的有线网卡的属性里已勾选了“VirtualBox Bridged Networking Driver”项。如下图:
wiwizvbox-cn11.jpg

本文章由 http://www.wifidog.pro/2015/03/18/wifidog%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97.html整理编辑,转载请注明出处

wifidog 配置中文说明+wifidog域名白名单简单实现

wifidog.conf:

#网关ID
GatewayID default
#外部网卡
ExternalInterface eth0
#无线网卡
GatewayInterface eth0
#无线IP
GatewayAddress 192.168.1.1
#路由状态HTML
HtmlMessageFile wifidog-msg.html 
#验证服务器
#AuthServer {
#    Hostname                 (Mandatory; Default: NONE)
#    SSLAvailable             (Optional; Default: no; Possible values: yes, no)
#    SSLPort                  (Optional; Default: 443)
#    HTTPPort                 (Optional; Default: 80)
#    Path                     (Optional; Default: /wifidog/ Note:  The path must be both prefixed and suffixed by /.  Use a single / for server root.)
#   LoginScriptPathFragment  (Optional; Default: login/? Note:  未用户登录重定向地址.)
#   PortalScriptPathFragment (Optional; Default: portal/? Note:  登录成功后重定向地址.)
#   MsgScriptPathFragment    (Optional; Default: gw_message.php? Note:  退出登录后重定向地址.)
#   PingScriptPathFragment    (Optional; Default: ping/? Note:  路由状态心跳地址.)
#   AuthScriptPathFragment    (Optional; Default: auth/? Note:  路由请求服务器验证地址 and 验证心跳地址(stage=counters).)
#}

AuthServer {
    Hostname auth.com
    #SSLAvailable yes
    Path /
}

# 是否后台进程
# Daemon 1
#默认网关端口
# Default: 2060
GatewayPort 80

# HTTP进程名
# HTTPDName WiFiDog

# HTTP最大连接数
# Default: 10
# HTTPDMaxConn 10

# WEB页面加密码后显示名
# Default: WiFiDog
# HTTPDRealm WiFiDog

# WEB加验证
# HTTPDUserName admin
# HTTPDPassword secret

# 心跳间隔时间
# Default: 60
CheckInterval 60

# 心跳间隔次数 验证超时数等于 CheckInterval*ClientTimeout 
ClientTimeout 2

# 信任的MAC地址,加入信任列表将不用登录可访问
#TrustedMACList 00:00:DE:AD:BE:AF,00:00:C0:1D:F0:0D

#其他防火墙设置

#全局
FirewallRuleSet global {
    ## To block SMTP out, as it's a tech support nightmare, and a legal liability
    #FirewallRule block tcp port 25

    ## Use the following if you don't want clients to be able to access machines on 
    ## the private LAN that gives internet access to wifidog.  Note that this is not
    ## client isolation;  The laptops will still be able to talk to one another, as
    ## well as to any machine bridged to the wifi of the router.
    # FirewallRule block to 192.168.0.0/16
    # FirewallRule block to 172.16.0.0/12
    # FirewallRule block to 10.0.0.0/8

    ## This is an example ruleset for the Teliphone service.
    #FirewallRule allow udp to 69.90.89.192/27
    #FirewallRule allow udp to 69.90.85.0/27
    #FirewallRule allow tcp port 80 to 69.90.89.205
}

# 新验证用户
FirewallRuleSet validating-users {
    FirewallRule allow to 0.0.0.0/0
}

#正常用户
FirewallRuleSet known-users {
    FirewallRule allow to 0.0.0.0/0
}

#未知用户
FirewallRuleSet unknown-users {

#域名已修改源码实现,直接下载的不行的...
    FirewallRule allow to baidu.com
    FirewallRule allow udp port 53
    FirewallRule allow tcp port 53
    FirewallRule allow udp port 67
    FirewallRule allow tcp port 67
}

#锁住用户
FirewallRuleSet locked-users {
    FirewallRule block to 0.0.0.0/0
}

域名过滤支持:
fw_iptables.c
iptables_compile 修改:

    if (rule->mask != NULL) {
        char *mask=rule->mask;
        int mask_len=strlen(mask);
        int is_domain=0,
            i=0;
        for(;i<mask_len;i++){
            if((mask[i]>=46&&mask[i]<=57)||mask[i]==32){
                continue;
            }else{
                is_domain=1;
                break;
            }
        }
        char * ip =NULL;
        if(is_domain){
            struct in_addr * h_addr =wd_gethostbyname(mask);
            if(h_addr){
                ip= safe_strdup(inet_ntoa(*h_addr));
                free(h_addr);
            }
            if(ip){
                mask=ip;
            }else{
                debug(LOG_ERR, "doamin %s not find ip try again!",mask);
                mask="0.0.0.0";
            }
        }
        snprintf((command + strlen(command)), (sizeof(command) -
                    strlen(command)), "-d %s ", mask);
        if(ip){
            free(ip);
        }
    }

conf.c
_parse_firewall_rule 修改:

    for (i = 0; *(mask + i) != '\0'; i++)
            if (!isdigit((unsigned char)*(mask + i))
                    &&!isalpha((unsigned char)*(mask + i))
                    && (*(mask + i) != '-')
                    && (*(mask + i) != '.')
                    && (*(mask + i) != '/'))
                all_nums = 0; /*< No longer only digits */

本文章由 http://www.wifidog.pro/2015/03/18/wifidog-%E9%85%8D%E7%BD%AE%E4%B8%AD%E6%96%87%E8%AF%B4%E6%98%8E.html整理编辑,转载请注明出处