认证服务器安装
需求
PHP5

• PHP5网络服务器。推荐Apache httpd服务器，并提义使用虚拟主机。
• 必用：Pgsql,dom,bmstring
• 选用：xml,gettext,mcrypt,mhash,xmlrpc
• PEAR：radius,Auth_RADIUS,Crypt_CHAP
• PHP library：Smarty,MagpieRSS,Phlickr

强烈建议安装选用项，以便激活认证服务器的所有特性。如果你不知道哪些已经安装，install.php将会进行检测并显示出对你有用的信息。最后一项将会通过install.php自动下载安装。

重点：认证服务器所需内存要大于PHP默认的8Mb。你需要在php.ini将其提高到32Mb或64Mb。如果你没进行此操作，也会安装成功，但不久就会用光内存。

PostgreSQL
正确配置PostgreSQL服务器。install.php脚本不会向PostgreSQL数据库服务器提供特殊的安全方式。系统管理员要做的是授予正确的数据库存取许可。

快速安装
1）将Wifidog认证服务器软件源从CVS中撤出
2）在人喜欢的浏览器中打开http://server.com/wifidog/install.php并按说明操作
3）在config.php设置语言
4）用管理员身份登录，填入网络信息，创建热点和目录

install.php
即使是install.php也无法尽其所能的来简化安装。但它能很快的给你一个门户，你可以做为管理员进行登录，自定义你的网络，热点，目录，用户等。
首先，你需要在浏览器中打开install.php。如果你尝试另一个门户网页，并且认证服务器没有预先设置好，那么你的浏览器将自动重新导向install.php。

按照网页上的说明创建wifidog用户和数据库。
第一次打开install.php，脚本会在/tmp/dog_cookie.txt文件中随机产生密码。这只是一种安全控制，用来防止选程用户用新安装的认证服务器做坏事。这个文件只是随机密码，不需要用户名。

本文章由 http://www.wifidog.pro/2015/03/06/wifidog%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%AE%89%E8%A3%85.html 整理编辑，转载请注明出处

Wifidog 网关安装
需求：
1）熟悉GNU/Linux环境
2）内核中编译了netfilter的GNU/Linux OS
3）Iptables
4）GNU C 编辑器。其它编辑器可能也适用，但我们没有测试，也不支持。
5）可以从SourceForge得到最新的Wifidog TAR包

预安装
很多人会在这里遇到问题，所以我们大致陈述一下：
将Wifidog引入到环境之前先要确保一切都是正常运行

• 路由器须boot正确
• 路由器能正确调出界面
• 路由器须联网
• 正确设置DNS，并能正常运行
• 正确设置DHCP
• 装载ipt_mac.o内核模块
• 如果用NAT,路由器必须用iptables设置NAT/masquerading规则
• 获取WIFI的客户端必面能够绑定和联接到互联网
• 当路由器开始运行时，以上所有须自动运行

安装
Wifidog跟其它开源项目一样，使用标准的自动化工具，使得安装更加便捷。打开TAR包获取来自SVN的最新资源，然后按以下步骤：

./autogen.sh
make
make install

如果你没有用make install来安装，二进制文件会保存在src/wifidgo。

OpenWrt ipkg

mkdir ~/wifidog.openwrt
cd ~/wifidog.openwrt
wget http://downloads.openwrt.org/whiterussian/newest/OpenWrt-SDK-Linux-i686-1.tar.bz2
tar -jxvf OpenWrt-SDK-Linux-i686-1.tar.bz2
svn checkout https://dev.wifidog.org/svn/trunk/wifidog
cd wifidog
./autogen.sh
make ipk OPENWRTSDK=~/wifidog.openwrt/OpenWrt-SDK-Linux-i686-1

如果没有错误，你的包应该保存在~/wifidog.openwrt/OpenWrt-SDK-Linux-i686-1/bin/packages

配置
编辑/etc/wifidog.conf并依照说明操作，一切OK。

首次运行Wifidog
按照以下命令启动Wifidog：

Wifidog –f –d 7

测试：
当客户端获取WIFI后，用浏览器打开你喜欢的网页。
监测运行当中的Wifidog的output。

本文章由 http://www.wifidog.pro/2015/03/06/wifidog-%E7%BD%91%E5%85%B3%E5%8D%8F%E8%AE%AE%E5%AE%89%E8%A3%85.html 整理编辑，转载请注明出处

认证服务器常见问题
Wifidog认证服务器相关问题

问：运行认证服务器的要求是什么？
答：1）网络服务器：Apache，IIS
2）拥有PHP5模块的网络服务器
3）PostgreSQL >= 8.0
根据不同的特性，你需要：
1）为RSS支持，扩大PHP DOM。
2）为RADIUS认证支持，PEAR Radius。
3）为网络相薄的内容，Phlick API。

问：我可以用PostgreSQL代替MySQL吗？
答：不可以。不考虑支持MySQL。要做到支持两者并要保证质量，是非常有压力的。这不是你的简单的互联网应用或者CMS。如果你想了解更多，在邮箱列单里有长篇文档。

问：CMS太复杂了，我想将HTML代码加到门户网页。
答：我们意识到我们需要提供一个更好的文档。然而这个问题的答案很简单。你只要简单的使用“TrivialLangstring”目录，在文本框里加入一些HTML代码，并将这目录与门户网页绑定在一起就可以了。

问：我可以用XML格式提取热点状态数据吗？
答：可以，可以输出XML格式的热点状态数据列表。事实上，谷歌地图整合Wifidog部分就是依赖这一特性。Ile Sans Fil也在他的主页面上使用XSL样式表来创建特定格式的展示。

问：我的认证服务器之前特别快，但现在越来越慢，甚至无加载
答：你需要
1）建个脚本，经常运行一下VACUUM ANALYZE（清理数据库表垃圾空间并优化查询）
2）确保上诉脚本能正常运行
3）如果发现你的认证服务器逐渐变慢，动行一次VACUUM FULL ANALYZE，然后进入第二步
注解：如果你有规律的运行VACUUM ANALYZE，那么你就不需要VACUUM FULL ANALYZE。然而如果你很长时间没有运行VACUUM ANALYZE了，那么你需要运行一次VACUUM FULL ANALYZE.
问题在于没有进行资料移除处理，那么联接和节点表格会逐渐增加。简单的数据移除不会收回被旧元组占用的空间，只是使他们能够被重新利用。如果你长时间没有运行VACUUM，你可能会有大量一天内无法用完的空余元组。VACUUM FULL ANALYZE弥补了这点。你必须每处理20M时运行一次VACUUM，这样可以避免XID产生更多信息。
选择性的运性周期性VACUUM，可以使autovacuum daemon在近期的PostgreSQL版本中得以实现。那时当数据库符合要求，PostgreSQL将自动移除此数据库。

问：认证页上有错误信息出现
答：检查认证服务器上显示的常见警告错误信息。

问：法语和日语字出现乱码
答：确认config.php有合适的设置区域。你也可能需要去规定Apache的字符集，把这行加入到你的httpd.conf：

AddDefaultCharset UTF-8

问：我的服务器不能发送邮件
或者会得到下列错误提示
1PHPMailer无法发送邮件。错误是：不能实例化mail函数
答：默认状态下，wifidog是通过PHPMailer来使用PHP 的mail()函数的。这信息是实际上是错误的。它是想说呼叫PHP的 mail()函数失败，大概是因为你的系统里没有安装邮件客户端。你也可以：
1）安装一个，并且确保他能够成功发送邮件
2）将wifidog/config.php改换成SMTP服务器来代替mail()
3）有时PHP能够用mail()来发送邮件但仍无效

本文章由 http://www.wifidog.pro/2015/03/05/wifidog%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98.html 整理编辑，转载请注明出处

网关常见问题：
关于Wifidog网关的问题

问题：我的客户端在1到5分钟后会断开链接
回答：跟其它解决方法不同，Wifidog无需一直打开认证页面用脚本来保持连接。网关只会在数秒中没有获得任何来自客户端的流量时，才判断为超时断开连接。确保客户端没有因为闲置而超时，网关将会在每个时间间隔来重新ping每个客户端来检测流量。遗憾的是，有些所谓防火墙设置很讨厌，防ping，造成检测时完全丢包被误判为离线。这也是经常超时的原因。

问：运行网关的要求是什么？
答：网关的要求是：
1）Linux的操作系统
2）Linux内核当中编译了netfilter 及iptables
3）IP信息包过滤系统
也可以视情况而定的进行宽带限制：
1）iproute2，特别是tc

问：我如何安装？
答：Wifidog跟其它开源项目一样，使用标准的自动化工具，使得安装更加便捷。打开TAR包获取来自SVN的最新资源，然后按以下步骤：

./autogen.sh
make
make install

如果你没有用make install来安装，二进制文件会保存在src/wifidgo。

问：我如何在Linksys WRT54G家庭路由器安装它？
答：如果你不习惯使用Linux并且不知道如何编辑这些问题，你可以使用别人编辑的OpenWRT和Wifidog。他们肯定会为你的特殊版本的OpenWRT编译。注意的是开源版本的IPK包或者由你自己的资源建立的，都是我们唯一提供服务的包。如果你使用了由其它组织发布的包，你必须向他们寻求服务。
1）下载一个重新编辑的OpenWRT固件镜像
2）通过路由器的网络接口安装固件镜像。
3）重点：在你安装Wifidog之前，确保连接在你OpenWRT路由器的客户端能够正确的使用网络
4）下载一个官方由Wifidog项目建立的.IPK文件。
5）安装Wifidog
6）按照文件的说明操作，一切将不言自明。

问：我可以登录，但当我点击开始按钮时，我被返回到登录界面
答：确保ipt_mac.o核心模块和ipt_mark核心模块已加载完毕。这些是IP信息包过滤系统的可选部分，经常被默认设置否认。在大多数Linux发布中，核心模块被配置在"/etc/modules.conf" or "/etc/modules".

本文章由 http://www.wifidog.pro/2015/03/05/wifidog%E7%BD%91%E5%85%B3%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98.html 整理编辑，转载请注明出处