add:mirror_workflow

chore:add_guide

.github/workflows/build-zzz.yml

@@ -0,0 +1,138 @@
+name: Build luci-app-zzz
+
+on:
+  workflow_dispatch:
+    inputs:
+      sdk:
+        description: '选择架构'
+        required: true
+        type: choice
+        options:
+          - ramips
+          - filogic
+          - x86_64
+        default: filogic
+
+env:
+  RAMIPS_SDK_URL: https://downloads.immortalwrt.org/releases/24.10.3/targets/ramips/mt7621/immortalwrt-sdk-24.10.3-ramips-mt7621_gcc-13.3.0_musl.Linux-x86_64.tar.zst
+  FILOGIC_SDK_URL: https://downloads.immortalwrt.org/releases/24.10.3/targets/mediatek/filogic/immortalwrt-sdk-24.10.3-mediatek-filogic_gcc-13.3.0_musl.Linux-x86_64.tar.zst
+  X86_SDK_URL:  https://downloads.immortalwrt.org/releases/24.10.3/targets/x86/64/immortalwrt-sdk-24.10.3-x86-64_gcc-13.3.0_musl.Linux-x86_64.tar.zst
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install dependencies
+        run: |
+          echo "👉 正在下载依赖项"
+          sudo apt-get update
+          sudo apt-get install -y build-essential git wget python3 rsync zstd g++ make libncurses-dev
+          echo "✅ 下载完毕"
+
+      - name: Resolve SDK choice
+        id: vars
+        run: |
+          set -e
+          if [ "${{ github.event.inputs.sdk }}" = "x86_64" ]; then
+            echo "SDK_URL=${X86_SDK_URL}" >> $GITHUB_ENV
+            echo "PACKAGE_ARCH=x86_64" >> $GITHUB_ENV
+            echo "👉 选择x86_64架构"
+          elif [ "${{ github.event.inputs.sdk }}" = "filogic" ]; then
+            echo "SDK_URL=${FILOGIC_SDK_URL}" >> $GITHUB_ENV
+            echo "PACKAGE_ARCH=aarch64_cortex-a53" >> $GITHUB_ENV
+            echo "👉 选择aarch64架构"
+          else
+            echo "SDK_URL=${RAMIPS_SDK_URL}" >> $GITHUB_ENV
+            echo "PACKAGE_ARCH=ramips" >> $GITHUB_ENV
+            echo "👉 选择ramips架构"
+          fi
+          echo "WORK_ROOT=$GITHUB_WORKSPACE/imwrt-sdk" >> $GITHUB_ENV
+
+      - name: Download & extract SDK
+        run: |
+          set -euo pipefail
+          mkdir -p "$WORK_ROOT"
+          cd "$WORK_ROOT"
+
+          SDK_TAR="$(basename "$SDK_URL")"
+          echo "👉 正在下载SDK：$SDK_TAR"
+          wget -q "$SDK_URL" -O "$SDK_TAR"
+
+          echo "📦 正在解压SDK..."
+          tar --use-compress-program="zstd -q -d" -xf "$SDK_TAR" >/dev/null 2>&1
+
+          echo "✅ SDK解压完成"
+          SDK_ROOT="$(find . -maxdepth 1 -type d -name 'immortalwrt-sdk*' | head -n 1)"
+          if [ -z "$SDK_ROOT" ]; then
+            echo "❌ 未找到SDK目录" >&2
+            exit 1
+          fi
+          SDK_ROOT="$(cd "$SDK_ROOT" && pwd)"
+          echo "SDK_ROOT=$SDK_ROOT" >> $GITHUB_ENV
+          echo "📁 SDK路径: $SDK_ROOT"
+
+      - name: Setup feeds & clone source
+        run: |
+          set -euo pipefail
+          cd "$SDK_ROOT"
+          echo "👉 正在设置feeds"
+          ./scripts/feeds update -a
+          ./scripts/feeds update luci || true
+          ./scripts/feeds install -a -p luci || ./scripts/feeds install luci || true
+          echo "✅ feeds下载完毕"
+          cd package
+          git clone https://github.com/Dichgrem/luci-app-nyn.git
+          cp -r luci-app-nyn/luci-app-zzz . 2>/dev/null || true
+          cp -r luci-app-nyn/zzz . 2>/dev/null || true
+          rm -rf luci-app-nyn
+
+      - name: Build luci-app-zzz
+        run: |
+          set -euo pipefail
+          cd "$SDK_ROOT"
+          make defconfig
+          echo "👉 正在编译中"
+          make package/luci-app-zzz/compile V=s
+          echo "✅ 编译完成"
+
+      - name: Collect packages
+        run: |
+          set -euo pipefail
+          SDK_ROOT="$SDK_ROOT"
+          OUT="$GITHUB_WORKSPACE/output"
+          mkdir -p "$OUT"
+
+          echo "🔍 自动检测 SDK 包架构目录..."
+          BASE_DIR=$(find "$SDK_ROOT/bin/packages" -type d -path "*/base" | head -n1 || true)
+          if [ -z "$BASE_DIR" ]; then
+            echo "❌ 未找到 base 目录" >&2
+            ls -R "$SDK_ROOT/bin/packages" || true
+            exit 1
+          fi
+
+          echo "📦 从: $BASE_DIR 收集 luci-app-zzz 与 zzz 包..."
+          ls -lah "$BASE_DIR" || true
+
+          cp -v "$BASE_DIR"/*luci-app-zzz*.ipk "$OUT"/ 2>/dev/null || true
+          cp -v "$BASE_DIR"/*zzz*.ipk "$OUT"/ 2>/dev/null || true
+
+          echo "✅ 收集完成，输出目录内容："
+          ls -lah "$OUT"
+        shell: bash
+
+      - name: Upload package one
+        uses: actions/upload-artifact@v4
+        with:
+          name: luci-app-zzz
+          path: output/*luci-app-zzz*.ipk
+          if-no-files-found: error
+
+      - name: Upload package two
+        uses: actions/upload-artifact@v4
+        with:
+          name: zzz
+          path: output/*zzz*.ipk
+          if-no-files-found: error

.github/workflows/mirror-to-codeberg.yml

@@ -0,0 +1,38 @@
+name: Mirror to Codeberg
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '*'
+
+jobs:
+  mirror:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Push to Codeberg
+        env:
+          SSH_PRIVATE_KEY: ${{ secrets.SSH_PRIVATE_KEY_CODEBERG }}
+          REPO_URL_CODEBERG: ${{ secrets.REPO_URL_CODEBERG }}
+        run: |
+          set -euxo pipefail
+
+          mkdir -p ~/.ssh
+          echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_ed25519
+          chmod 600 ~/.ssh/id_ed25519
+          cat >> ~/.ssh/config <<EOF
+          Host codeberg.org
+            IdentityFile ~/.ssh/id_ed25519
+            StrictHostKeyChecking no
+          EOF
+
+          git config --global user.name "GitHub Actions"
+          git config --global user.email "github-actions@github.com"
+
+          git remote add codeberg "$REPO_URL_CODEBERG"
+          git push --tags --force --prune codeberg "refs/remotes/origin/*:refs/heads/*"

README.md

@@ -6,6 +6,17 @@
   <img src="https://github.com/Dichgrem/luci-app-nyn/blob/main/screenshot.png" width="400">
 </p>
 
+> Attention ! The nyn project is archived and it is recommended to use the c language version of zzz instead of it ! In order to commemorate nyn, the name of this project is not modified.
+
+## How to use
+
+- Step 0: Make sure you have an ``openwrt router``, ``download the ipk`` in Releases in this project, and ``upload and install`` it in the system-package of the Luci background.
+- Step 1：Fill in the user name: Student ID@operator. For example, ``212306666@cucc``, China Unicom is cucc, mobile is cmcc, and telecom is ctcc.
+- Step 2: Fill in the password. The ``initial password`` is the last six digits of the ID card by default. It can be modified in the official client.
+- Step 3: Select your network card; generally speaking, you can use ``ip addr`` to view the network card that has been assigned an IP, such as eth1.
+- Step 4: ``Start the service`` and observe whether you can access the Internet, and then enable ``scheduled startup``; because the campus network will be closed from 12:00 to 7:00 the next day.
+- Finally，enjoy it!
+
 ## How to build
 
 - First clone this repository to the package directory of the openwrt you want to compile:
@@ -13,32 +24,35 @@
 ```
 cd ./package
 git clone https://github.com/Dichgrem/luci-app-nyn.git
+cp -r ./luci-app-nyn/luci-app-zzz ./
+cp -r ./luci-app-nyn/zzz ./
+rm -rf ./luci-app-nyn
 ```
-- Then select ``Network->nyn`` and ``LuCI->Applications->luci-app-nyn`` in make menuconfig and change them to "M" state;
+- Then select ``Network->zzz`` and ``LuCI->Applications->luci-app-zzz`` in make menuconfig and change them to "M" state;
 
 - Finally, run
 ```
-make package/luci-app-nyn/clean V=s
-make package/luci-app-nyn/compile V=s 
+make package/luci-app-zzz/clean V=s
+make package/luci-app-zzz/compile V=s
 ```
 and
 ```
-make package/nyn/clean V=s
-make package/nyn/compile V=s
+make package/zzz/clean V=s
+make package/zzz/compile V=s
 ```
 to start build.
 
 - You can use this command to find the compiled ipk:
 
 ```
-❯ find bin/ -name "nyn*.ipk"
-bin/packages/x86_64/base/nyn_1.0.0-r1_x86_64.ipk
-❯ find bin/ -name "luci-app-nyn*.ipk"
-bin/packages/x86_64/base/luci-app-nyn_0_all.ipk
+❯ find bin/ -name "zzz*.ipk"
+bin/packages/x86_64/base/zzz_1.0.0-r1_x86_64.ipk
+❯ find bin/ -name "luci-app-zzz*.ipk"
+bin/packages/x86_64/base/luci-app-zzz_0_all.ipk
 ```
 
 ## Acknowledgements
 
+- [diredocks/zzz](https://github.com/diredocks/zzz)
 - [diredocks/nyn](https://github.com/diredocks/nyn)
 - [bitdust/njit8021xclient](https://github.com/bitdust/njit8021xclient)
-

luci-app-zzz/luasrc/controller/zzz.lua

@@ -17,7 +17,7 @@ function index()
 end
 
 function service_control()
-    local sys = require "luci.sys"
+	local sys = require("luci.sys")
 	local action = luci.http.formvalue("action")
 	local result = { success = false, message = "" }
 
@@ -48,8 +48,8 @@ function service_control()
 end
 
 function act_status()
-    local sys = require "luci.sys"
-    local util = require "luci.util"
+	local sys = require("luci.sys")
+	local util = require("luci.util")
 	local status = {}
 
 	-- Get status
@@ -59,7 +59,6 @@ function act_status()
 	if status.running then
 		status.process_info = util.trim(sys.exec("ps | grep -v grep | grep zzz"))
 	end
-
 	-- Get log
 	local log_file = "/tmp/zzz.log"
 	if nixio.fs.access(log_file) then

luci-app-zzz/luasrc/model/cbi/zzz.lua

@@ -1,6 +1,6 @@
 -- /usr/lib/lua/luci/model/cbi/zzz.lua
 local m, s, o
-local sys = require "luci.sys"
+local sys = require("luci.sys")
 
 -- control
 local start_action = luci.http.formvalue("cbid.zzz.auth.start_service")
@@ -15,8 +15,7 @@ elseif restart_action then
 	sys.call("/etc/rc.d/S99zzz stop; sleep 2; /etc/rc.d/S99zzz start")
 end
 
-m = Map("zzz", "ZZZ 802.1x 认证客户端",
-    "配置使用 zzz 客户端进行网络访问的 802.1x 认证")
+m = Map("zzz", "ZZZ 802.1x 认证客户端", "配置使用 zzz 客户端进行网络访问的 802.1x 认证")
 
 -- Authentication Settings
 s = m:section(TypedSection, "auth", "认证设置")
@@ -27,7 +26,7 @@ s.addremove = false
 o = s:option(DummyValue, "_status", "当前状态")
 o.rawhtml = true
 o.cfgvalue = function()
-    local sys = require "luci.sys"
+	local sys = require("luci.sys")
 	local running = sys.call("pgrep zzz >/dev/null") == 0
 	if running then
 		return "<span style='color:green;font-weight:bold'>✔ 正在运行中</span>"
@@ -53,17 +52,39 @@ control_buttons.cfgvalue = function()
 end
 
 -- Username
-o = s:option(Value, "user", "用户名", "802.1x 认证用户名")
+o = s:option(
+	Value,
+	"username",
+	"用户名",
+	[[802.1x 认证用户名
+<span style="cursor: help; color: #007bff; font-weight: bold;" title="用户名为学号@运营商，例如212306666@cucc；移动为cmcc，联通为cucc，电信为ctcc">?</span>]]
+)
 o.password = true
 o.rmempty = false
+o.rawhtml = true
 
 -- Password
-o = s:option(Value, "password", "密码", "802.1x 认证密码")
 o.password = true
 o.rmempty = false
+o = s:option(
+	Value,
+	"password",
+	"密码",
+	[[802.1x 认证密码
+<span style="cursor: help; color: #007bff; font-weight: bold;" title="密码默认为身份证号后六位，可以在官方客户端inode中修改">?</span>]]
+)
+o.password = true
+o.rmempty = false
+o.rawhtml = true
 
 -- Network Device
-o = s:option(ListValue, "device", "网络接口", "用于认证的网络接口")
+o = s:option(
+	Value,
+	"device",
+	"网络接口",
+	[[用于认证的网络接口
+<span style="cursor: help; color: #007bff; font-weight: bold;" title="可以用ip addr命令查看，有10.38开头ip的接口">?</span>]]
+)
 o.rmempty = false
 o:value("eth0", "eth0")
 o:value("eth1", "eth1")
@@ -93,7 +114,9 @@ auto_start.write = function(self, section, value)
 	if value == "1" then
 		-- 启用定时任务：每周一至周五 7:00 启动
 		sys.call("(crontab -l 2>/dev/null | grep -v 'S99zzz' | grep -v '# zzz auto') | crontab - 2>/dev/null")
-        sys.call("(crontab -l 2>/dev/null; echo '0 7 * * 1,2,3,4,5 /etc/rc.d/S99zzz start # zzz auto start') | crontab -")
+		sys.call(
+			"(crontab -l 2>/dev/null; echo '0 7 * * 1,2,3,4,5 /etc/rc.d/S99zzz start # zzz auto start') | crontab -"
+		)
 		sys.call("/etc/init.d/cron enable && /etc/init.d/cron restart")
 	else
 		-- 禁用定时任务
@@ -114,4 +137,10 @@ timer_status_display.cfgvalue = function()
 	end
 end
 
+-- 保存后自动重启 zzz 服务
+m.on_commit = function(self)
+	local sys = require("luci.sys")
+	sys.call("/etc/rc.d/S99zzz restart >/dev/null 2>&1 &")
+end
+
 return m