韶关学院校园网第三方拨号器

注意

• 换认证方案商了。新方案不需要客户端,这个项目没用了，见SGU-Script

关于

        SGUClient是一个纯C系语言编写的韶关学院学生宿舍区第三方网络认证拨号器。现在有Ubuntu和OpenWrt二进制文件可用。当然了，得益于C系语言良好的可移植性，你可以获得SGUClient的源代码然后轻松移植到你需要的平台上（Feel free to make changes）。
        SGUClient内置2套拨号协议，所以在全校、全网应该都可以正常使用。准确来说，兼容电信和移动网络，兼容南区、北区和西区网络，兼容Drcom拨号器和新旧小蝴蝶拨号器。但黄田坝校区和紫藤苑未经实地测试。
        现在SGUClient也有了LuCI图形化配置页面，所以在OpenWrt路由器上运行SGUClient或许是一个不错的选择。

严肃警告

• 仅可用于学习目的

       SGUClient及其有关资料仅可供韶关学院师生用于学习计算机网络知识、学习计算机编程知识的用途，其他任何用途均为不正常使用。由于不正常使用所导致的一切直接或间接后果及法律责任均由使用者自行承担，SGUClient作者不承担任何责任。

• 禁止用于商业用途

       特别指出禁止任何个人或团体将SGUClient或其有关资料用于商业目的。由此造成的后果与法律责任均与开发者、公众号持有者以及QQ群友无关！

• 从未授权任何商业、推广活动

       SGUClient是免费、开源软件，用户无需为其支付任何费用！

       SGUClient的开发者从未授权任何形式的商业活动、推广活动，也不提供任何付费服务。一切与SGUClient有关的商业活动、推广活动（包括但不限于收费代刷路由器、收费上门推广安装WiFi等）均为不正常使用的行为。SGUClient开发者对这些不正常使用的行为不知情、不支持、不鼓励，也不会承担任何责任。你在参与这些不正常使用的行为中付出的代价（例如跑路、金钱损失、隐私信息被盗泄露、封号等）均与SGUClient开发者无关！

• 不鼓励用于分享网络

       SGUClient的出发点是给韶关学院师生提供一些可供学习研究的编程资料，因此不鼓励利用SGUClient或其有关资料进行分享网络的行为（包括但不限于开WiFi、多人合用一条宽带等）。与他人分享网络可能是违规行为！

• 抵制商业用途

       窃取他人免费、开源的劳动成果用来赚钱是不道德的行为；付费让别人代刷路由器是助纣为虐的行为，更是对自己的隐私安全不负责任的行为。

       收费代刷路由器、收费上门推广安装WiFi等高调作死行为只会加速得罪有关利益方，让别人尽快封杀SGUClient。哪天没得研究了就是你们这些人亲手造成的；

       同时，这些上门代刷的路由器中会不会偷偷安插了木马病毒软件用于盗号、盗取隐私、窃取机密资料等违法犯罪用途，只有代刷路由器的人自己知道，谁都不敢保证。为了你自己的隐私安全，请勿轻信收费代刷路由器、收费上门推广安装WiFi等服务。

你必须完全阅读、理解并接受以上内容才可以继续使用SGUClient及其相关资料。

如果你不明白或不接受以上内容，请勿使用SGUClient，并且立即将SGUClient及其相关资料从你的设备中移除。

快速上手

• Ubuntu使用SGUClient
  
• OpenWrt(路由器)使用SGUClient
  

编译

• Ubuntu编译SGUClient
  
• 交叉编译SGUClient For OpenWrt

故障排除

• 故障排除

2022年六月更新

• 电信网络方面
  • 实现2020年底电信拨号协议改版后的新心跳包,可解决原先版本电信11分钟掉线的问题    好消息!电信不掉线啦
  • 大幅度修正DrCom部分代码,并增加大量注释
  • 修正当自动重连开启时DrCom部分可能会在掉线重登后表现异常
  • 优化了日志输出,默认使用抽象日志
  • 规避了U244登录后连回两包(登录确认+公告)导致代码异常. 注:此为Dirty hack日后应当改用更规范的方法
• 整体程序方面
  • 修改了网络接口相关代码,解决了部分系统上获取本地IP错误/使用错误的参数初始化socket导致的各种混乱.同时不再需要用户手动传入网卡IP,避免手抖
  • 优化文件锁加锁流程
  • 使用extern来处理全局变量,解决较新的编译器报符号重复定义错误
  • 更新了程序运行参数处理部分,移除部分无用选项,同时删除了一些从fsn_server继承来的不必要的参数
  • 优化了print_hex_drcom函数,使得十六进制字节流的调试输出更加美观
  • 增加CodeQL的GithubAction,自动检查主分支语法错误(可以此为基础制作打包自动化)
  • 增加-k开关,可快速关闭其它SGUClient进程
  • 增加--debug，可输出更加详细的日志
• Openwrt插件方面
  • 显式声明了编译时使用C11标准
  • Luci面板增加日志查看功能,便于排错
  • 大幅度调整启动流程,顶层使用procd而不是死循环保活,解决之前版本在新版Openwrt上的兼容问题
  • 调整Luci面板文案
  • 增加调试模式，使程序出错时，方便用户自己解决错误

版权声明

SGUClient是很久很久之前弄的一个东西了，编写过程中借(chao)鉴(xi)了很多开源项目的源代码。主要有：

• drcom协议部分使用了fsn_server的源代码
• 程序框架使用了ZTE-Client的源代码
• LuCI部分使用了njit-client的LuCI部分源代码
  历史久远，如果有遗留，请联系我。
  感谢以上作者的辛勤付出。侵删。

欢迎star，欢迎fork，欢迎pull request，但禁止任何个人或团体将SGUClient用于商业目的，由此造成的后果与法律责任均与开发者、公众号持有者以及QQ群友无关！

Contributors

• dafeiyoung
  • 初版开发,测试,客服(?)
• FurryAcetylCoA
  • 适配新版电信心跳包
• IDeLoveYou
  • 重写了多线程处理
  • 软件测试

再说几句

a. 历时很多很多年改来改去的一个东西，当年shit一样的代码风格，所以请勿在饭前饭后阅读源代码。
b. 欢迎加入QQ群638138948讨论。韶关学院师生进群请备注“学院-年级-昵称”例如“信工-14-二狗子”，非韶关学院师生进入请备注学校（这只是为了方便统计，希望理解）。