feat: add CLI support with GUI and server mode, enhance release workflow for Linux binaries

Author: Licoy

.github/workflows/release.yml

@@ -53,11 +53,6 @@ jobs:
             args: ''
             rust_targets: ''
             name: linux-x86_64
-          # Linux ARM64
-          - platform: ubuntu-22.04-arm
-            args: ''
-            rust_targets: ''
-            name: linux-aarch64
           # Windows
           - platform: windows-latest
             args: ''
@@ -118,17 +113,46 @@ jobs:
           releaseId: ${{ needs.create-release.outputs.release_id }}
           args: ${{ matrix.args }}
 
-      - name: Package standalone binary (Linux)
-        if: contains(matrix.name, 'linux')
+  build-cli:
+    needs: create-release
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: ubuntu-22.04
+            target: x86_64-unknown-linux-gnu
+            arch: amd64
+          - platform: ubuntu-22.04-arm
+            target: aarch64-unknown-linux-gnu
+            arch: aarch64
+
+    runs-on: ${{ matrix.platform }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: './src-tauri -> target'
+
+      - name: Build CLI binary (no GUI dependencies)
+        working-directory: src-tauri
+        run: cargo build --release --no-default-features
+
+      - name: Package standalone binary
         run: |
-          ARCH=$([[ "${{ matrix.name }}" == *"aarch64"* ]] && echo "aarch64" || echo "amd64")
-          BINARY="src-tauri/target/release/fetch-github-hosts"
-          TAR_NAME="fetch-github-hosts_linux_${ARCH}.tar.gz"
-          tar -czf "$TAR_NAME" -C "$(dirname "$BINARY")" "$(basename "$BINARY")"
+          TAR_NAME="fetch-github-hosts_linux_${{ matrix.arch }}.tar.gz"
+          tar -czf "$TAR_NAME" -C "src-tauri/target/release" "fetch-github-hosts"
           echo "TAR_NAME=$TAR_NAME" >> "$GITHUB_ENV"
 
-      - name: Upload standalone binary (Linux)
-        if: contains(matrix.name, 'linux')
+      - name: Upload standalone binary
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |

src-tauri/Cargo.toml

@@ -12,6 +12,10 @@ rust-version = "1.77.2"
 name = "app_lib"
 crate-type = ["staticlib", "cdylib", "rlib"]
 
+[features]
+default = ["gui"]
+gui = ["dep:tauri", "dep:tauri-plugin-log", "dep:tauri-plugin-shell"]
+
 [build-dependencies]
 tauri-build = { version = "2.5.4", features = [] }
 
@@ -20,9 +24,9 @@ serde_json = "1.0"
 serde = { version = "1.0", features = ["derive"] }
 serde_yaml = "0.9"
 log = "0.4"
-tauri = { version = "2.10.0", features = ["macos-private-api", "tray-icon"] }
-tauri-plugin-log = "2"
-tauri-plugin-shell = "2"
+tauri = { version = "2.10.0", features = ["macos-private-api", "tray-icon"], optional = true }
+tauri-plugin-log = { version = "2", optional = true }
+tauri-plugin-shell = { version = "2", optional = true }
 tokio = { version = "1", features = ["full"] }
 reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
 dns-lookup = "2"

src-tauri/build.rs

@@ -1,3 +1,4 @@
 fn main() {
-  tauri_build::build()
+  #[cfg(feature = "gui")]
+  tauri_build::build();
 }

src-tauri/src/lib.rs

@@ -1,21 +1,25 @@
 pub mod cli;
+#[cfg(feature = "gui")]
 mod commands;
-mod config;
-mod dns;
-mod hosts;
-mod models;
-mod services;
+pub(crate) mod config;
+pub(crate) mod dns;
+pub(crate) mod hosts;
+pub(crate) mod models;
+pub(crate) mod services;
 
+#[cfg(feature = "gui")]
 use std::sync::Mutex;
+#[cfg(feature = "gui")]
 use services::{ClientState, ServerState};
+#[cfg(feature = "gui")]
 use tauri::{
     Manager,
     menu::{MenuBuilder, MenuItemBuilder},
     tray::TrayIconBuilder,
 };
 
 /// Detect system language and return supported locale code
-fn detect_system_lang() -> &'static str {
+pub fn detect_system_lang() -> &'static str {
     let lang = sys_locale::get_locale().unwrap_or_else(|| "en-US".to_string());
     if lang.starts_with("zh") {
         "zh-CN"
@@ -27,6 +31,7 @@ fn detect_system_lang() -> &'static str {
 }
 
 /// Known hosts origins (must match frontend)
+#[cfg(feature = "gui")]
 fn get_hosts_url(select_origin: &str, custom_url: &str, method: &str) -> String {
     if method == "custom" && !custom_url.is_empty() {
         return custom_url.to_string();
@@ -38,6 +43,7 @@ fn get_hosts_url(select_origin: &str, custom_url: &str, method: &str) -> String
 }
 
 /// Get tray menu text by key and locale
+#[cfg(feature = "gui")]
 fn tray_text(key: &str, lang: &str) -> &'static str {
     match (key, lang) {
         ("show", "zh-CN") => "显示主窗口",
@@ -76,6 +82,7 @@ fn tray_text(key: &str, lang: &str) -> &'static str {
     }
 }
 
+#[cfg(feature = "gui")]
 #[cfg_attr(mobile, tauri::mobile_entry_point)]
 pub fn run() {
     tauri::Builder::default()

src-tauri/src/main.rs

@@ -14,6 +14,15 @@ fn main() {
         });
     } else {
         // GUI mode: launch Tauri window
+        #[cfg(feature = "gui")]
         app_lib::run();
+
+        #[cfg(not(feature = "gui"))]
+        {
+            eprintln!("GUI mode is not available in this build.");
+            eprintln!("Use -m client or -m server for CLI mode.");
+            eprintln!("Example: fetch-github-hosts -m client");
+            std::process::exit(1);
+        }
     }
 }

src-tauri/src/services.rs

@@ -1,21 +1,27 @@
+#[cfg(feature = "gui")]
 use tauri::{AppHandle, Emitter};
+#[cfg(feature = "gui")]
 use tokio::sync::oneshot;
 
 use crate::dns;
 use crate::hosts;
+#[cfg(feature = "gui")]
 use crate::models::LogPayload;
 
 /// State for managing client ticker
+#[cfg(feature = "gui")]
 pub struct ClientState {
     pub stop_tx: Option<oneshot::Sender<()>>,
 }
 
 /// State for managing server ticker
+#[cfg(feature = "gui")]
 pub struct ServerState {
     pub stop_tx: Option<oneshot::Sender<()>>,
 }
 
 /// Start the client mode: periodically fetch hosts from remote URL
+#[cfg(feature = "gui")]
 pub async fn start_client_task(
     app: AppHandle,
     url: String,
@@ -85,6 +91,7 @@ pub async fn client_fetch_hosts(url: &str) -> Result<(), String> {
 }
 
 /// Start the server mode: resolve DNS and serve hosts via HTTP
+#[cfg(feature = "gui")]
 pub async fn start_server_task(
     app: AppHandle,
     port: u16,
@@ -160,6 +167,7 @@ pub async fn server_fetch_hosts() -> Result<(), String> {
 }
 
 /// Simple HTTP server for serving hosts files (async with graceful shutdown)
+#[cfg(feature = "gui")]
 async fn start_http_server(port: u16, app: AppHandle, mut shutdown_rx: tokio::sync::watch::Receiver<bool>) {
     use tokio::io::{AsyncReadExt, AsyncWriteExt};
     use tokio::net::TcpListener;