release: v0.1.19

Author: zengyufei

CHANGELOG.en.md

@@ -6,6 +6,13 @@ All notable changes to `ii` are documented here. The default Chinese version is
 
 Nothing yet.
 
+## 0.1.19 - 2026-07-31
+
+### Added
+
+- Added `ii web [directory]` for temporary LAN recursive directory browsing, normal file responses, and multi-file uploads; it supports `--token` and `--path`, and prints a QR code plus all IPv4 LAN URLs in the terminal.
+- Added `ii send ... --web --path <dir>` to write web uploads directly into a chosen directory; relative paths are based on the startup directory, while the default remains `./ii/`.
+
 ## 0.1.18 - 2026-07-30
 
 ### Added

CHANGELOG.md

@@ -6,6 +6,13 @@
 
 暂无。
 
+## 0.1.19 - 2026-07-31
+
+### 新增
+
+- 新增 `ii web [目录]`：临时提供局域网递归目录浏览、普通文件访问与多文件上传；支持 `--token` 和 `--path`，终端输出二维码与全部 IPv4 LAN URL。
+- `ii send ... --web --path <目录>` 可指定网页上传文件直接写入的目录；相对路径按启动目录解析，未指定时仍写入 `./ii/`。
+
 ## 0.1.18 - 2026-07-30
 
 ### 新增

Cargo.lock

@@ -4,7 +4,7 @@ exclude = ["vendor/iroh", "vendor/suppaftp"]
 resolver = "3"
 
 [workspace.package]
-version = "0.1.18"
+version = "0.1.19"
 edition = "2024"
 rust-version = "1.91"
 license = "MIT"

Cargo.toml

@@ -23,7 +23,7 @@
 
 - The sender serves one successful receive by default, then exits
 - It briefly probes for a usable path through complex networks, with S3, WebDAV, FTP, and SFTP backend options
-- `ii send <file-or-folder> --web` opens a temporary LAN download page
+- `ii send <file-or-folder> --web` opens a temporary LAN download page, while `ii web [directory]` browses a LAN directory
 - Receives resume automatically by default
 - Existing files with the same MD5 are skipped
 - Folders can be sent directly
@@ -131,9 +131,14 @@ Open a temporary LAN download page:
 ii send .\video.mp4 --web
 ii send .\my-folder --web
 ii send .\video.mp4 --web --token A1b2C3d4E5f6G7h8
+ii send .\video.mp4 --web --path .\uploads
+ii web
+ii web .\shared --token A1b2C3d4E5f6G7h8 --path .\uploads
 ```
 
-The command displays a QR code directly above the primary LAN URL for opening the download page, then lists the remaining physical and virtual adapter IPv4 URLs under `other:`. The QR code at the top of that page points directly to `/download` for phone downloads. The page can also upload multiple files into `./ii/` under the directory where the command started; directory uploads are not supported. Folders download as `.tar` archives. Press `Ctrl+C` to stop the server. Optional `--token <value>` adds a path access token to the page, download, and upload URLs; it must be 16 to 128 ASCII letters, digits, `-`, or `_`, and omitting it keeps the unprotected URLs. This mode has no account authentication and is intended only for short-lived, trusted LAN sharing.
+The command displays a QR code directly above the primary LAN URL for opening the download page, then lists the remaining physical and virtual adapter IPv4 URLs under `other:`. The QR code at the top of that page points directly to `/download` for phone downloads. The page can also upload multiple files into `./ii/` under the directory where the command started. Use `--path <dir>` to write directly into a different directory; relative paths are based on the startup directory, and the directory is created on the first upload. Directory uploads are not supported. Folders download as `.tar` archives. Press `Ctrl+C` to stop the server. Optional `--token <value>` adds a path access token to the page, download, and upload URLs; it must be 16 to 128 ASCII letters, digits, `-`, or `_`, and omitting it keeps the unprotected URLs. This mode has no account authentication and is intended only for short-lived, trusted LAN sharing.
+
+Without a path, `ii web` serves the directory where the command starts; with a path, it accepts only an existing directory. Its page provides recursive nginx-style directory browsing, normal file responses, and multi-file uploads. The terminal still shows the QR code, primary IPv4 LAN URL, and `other:` adapter URLs, but the directory page has no QR code. `--token` and `--path` follow the same rules as `ii send ... --web`; `-p` does not apply to `ii web`.
 
 Prefer local network paths and avoid public relays:
 

README.en.md

@@ -25,7 +25,7 @@
 
 自动找路 / 局域网优先 / 可公网中继或 `--s3` / `--webdav` / `--ftp` / `--sftp` 中继
 
-也可用 `ii send <文件或文件夹> --web` 临时开一个局域网下载页
+也可用 `ii send <文件或文件夹> --web` 临时开下载页，或用 `ii web [目录]` 浏览局域网目录
 
 断点续收 / 秒传跳过 / 冲突覆盖 / 支持传完清理中转
 
@@ -134,9 +134,14 @@ ii recv ii1k7v...x9a --stdout > project.tar.gz
 ii send .\video.mp4 --web
 ii send .\my-folder --web
 ii send .\video.mp4 --web --token A1b2C3d4E5f6G7h8
+ii send .\video.mp4 --web --path .\uploads
+ii web
+ii web .\shared --token A1b2C3d4E5f6G7h8 --path .\uploads
 ```
 
-命令行会在主局域网 URL 上方显示进入下载页的二维码，并在 `other:` 下列出其余物理和虚拟网卡的 IPv4 URL；下载页顶部的二维码则直达 `/download`，方便手机扫码下载。网页也可以一次上传多个文件，接收文件写到启动命令当前目录的 `./ii/`，不支持上传目录。目录会下载为 `.tar`。按 `Ctrl+C` 关闭服务。可选 `--token <value>` 为网页、下载和上传加路径访问令牌，令牌只能是 16 到 128 个 ASCII 字母、数字、`-` 或 `_`；不带时保持无令牌 URL。该模式没有账号鉴权，只适合临时、可信的局域网。
+命令行会在主局域网 URL 上方显示进入下载页的二维码，并在 `other:` 下列出其余物理和虚拟网卡的 IPv4 URL；下载页顶部的二维码则直达 `/download`，方便手机扫码下载。网页也可以一次上传多个文件，默认写到启动命令当前目录的 `./ii/`；可用 `--path <目录>` 改为直接写入指定目录，相对路径仍以启动目录为基准，目录会在首次上传时创建。不支持上传目录。目录会下载为 `.tar`。按 `Ctrl+C` 关闭服务。可选 `--token <value>` 为网页、下载和上传加路径访问令牌，令牌只能是 16 到 128 个 ASCII 字母、数字、`-` 或 `_`；不带时保持无令牌 URL。该模式没有账号鉴权，只适合临时、可信的局域网。
+
+`ii web` 不带路径时服务启动命令的当前目录；带路径时只接受已有目录。网页提供 nginx 风格的递归目录浏览、普通文件访问和多文件上传，终端输出同样有二维码、主 IPv4 LAN URL 与 `other:` 网卡 URL，但目录网页不显示二维码。`--token` 与 `--path` 的规则和 `ii send ... --web` 相同，`-p` 不适用于 `ii web`。
 
 局域网优先，不走公网中继：
 

README.md

@@ -28,6 +28,7 @@ All measurements use `cargo build -p ii --release --locked` followed by UPX
 | Web-share other IPv4 URL list | 5,979,648 | 2,160,640 | +1,024 | `cargo test -p ii --locked` (77 tests), isolated `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
 | Web-share bidirectional file upload | 5,992,960 | 2,166,784 | +5,632 | `cargo test -p ii --locked` (78 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
 | Web-share path access token | 6,001,664 | 2,169,344 | +2,560 | `cargo test -p ii --locked` (83 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
+| Web upload path and `ii web` directory service | 6,038,016 | 2,180,608 | +11,264 | `cargo test -p ii --locked` (92 tests), `cargo build -p ii --release --locked`, UPX `5.1.0 --best --lzma`, `upx -t` |
 
 Equivalent release rebuilds have varied by up to `1,536` UPX bytes; the latest
 measurement is recorded with the pinned `5.1.0` packer.

SIZE.md

@@ -4,12 +4,13 @@
 
 ## 一句话
 
-`ii send` 发，`ii recv` 收，`ii relay` 管中继，`ii doctor` 查问题，`ii version` 看版本。
+`ii send` 发，`ii recv` 收，`ii web` 开局域网目录，`ii relay` 管中继，`ii doctor` 查问题，`ii version` 看版本。
 
 ## 命令总览
 
 ```text
-ii send [<path>] [--name <name>] [-t] [-c] [-o <path>] [--web [--token <value>] | --s3 | --webdav | --ftp | --sftp] [--profile <name>] [-d] [-p] [--local] [--relay <https-url> [-k]] [--no-relay]
+ii send [<path>] [--name <name>] [-t] [-c] [-o <path>] [--web [--token <value>] [--path <dir>] | --s3 | --webdav | --ftp | --sftp] [--profile <name>] [-d] [-p] [--local] [--relay <https-url> [-k]] [--no-relay]
+ii web [<目录>] [--token <value>] [--path <目录>]
 ii recv <ticket> [-o <dir>] [--stdout] [--overwrite] [--resume] [--local] [--trace]
 ii relay (--public <https-url> | --tls <domain> --cert <path> --key <path>) [-H <bind-port>]
 ii doctor
@@ -78,11 +79,14 @@ tar czf - .\project | ii send --name project.tar.gz
   如果文件已存在，会覆盖。这个 `-o` 属于 `ii send`，不影响 `ii recv -o <dir>` 的保存目录语义。
 
 `--web`
-: 在局域网内临时开放一个无账号鉴权 HTTP 下载页。执行后会在主 URL 上方展示进入下载页的二维码，随后在 `other:` 下列出其余物理和虚拟网卡的 IPv4 URL；下载页顶部二维码直达 `/download`。网页可一次上传多个文件，接收文件写到启动命令当前目录的 `./ii/`，不支持上传目录。按 `Ctrl+C` 停止服务。文件直接下载；文件夹会按原目录名打包为 `.tar` 下载。它不生成 ticket，不能和 `-c`、`-o`、`--s3`、`--webdav`、`--ftp`、`--sftp`、`--local`、`--relay`、`--no-relay` 同时使用。
+: 在局域网内临时开放一个无账号鉴权 HTTP 下载页。执行后会在主 URL 上方展示进入下载页的二维码，随后在 `other:` 下列出其余物理和虚拟网卡的 IPv4 URL；下载页顶部二维码直达 `/download`。网页可一次上传多个文件，默认写到启动命令当前目录的 `./ii/`，不支持上传目录。按 `Ctrl+C` 停止服务。文件直接下载；文件夹会按原目录名打包为 `.tar` 下载。它不生成 ticket，不能和 `-c`、`-o`、`--s3`、`--webdav`、`--ftp`、`--sftp`、`--local`、`--relay`、`--no-relay` 同时使用。
 
 `--token <value>`
 : 仅和 `--web` 同用，把网页、下载和上传 URL 固定到 `/<value>/` 路径下；遗漏或写错路径会返回 `404`。`value` 必须为 16 到 128 个 ASCII 字母、数字、`-` 或 `_`。不提供时仍使用原来的无令牌 URL。
 
+`--path <dir>`
+: 仅和 `--web` 同用，指定网页上传文件直接写入的目录。相对路径以启动命令当前目录为基准；目录在首次上传时创建。不提供时仍写入当前目录的 `./ii/`。`-p` 仍是 FTP/SFTP/WebDAV 的便携 ticket 参数。
+
 `--local`
 : 只走局域网优先路径，不走公网发现，不走公网 relay。
 
@@ -134,6 +138,20 @@ tar czf - .\project | ii send --name project.tar.gz
 - 指定 `--relay https://...` 后，当前发送会强制走 HTTPS relay-only，不使用默认公网 relay。
 - 手工证书 relay 不带 `-k`；自签 relay 必须带 `-k`。
 
+## `ii web`
+
+```powershell
+ii web
+ii web .\shared
+ii web .\shared --token A1b2C3d4E5f6G7h8 --path .\uploads
+```
+
+`ii web` 不带路径时服务启动命令当前目录；带路径时必须是已有目录，文件路径会报错。网页提供 nginx 风格的递归目录浏览：目录可继续进入、`../` 返回父目录、每项显示名称、修改时间和大小；普通文件直接响应，不强制下载。网页顶部可一次上传多个独立文件，不支持上传目录。
+
+命令行会在主 IPv4 LAN URL 上方打印根页二维码，并在 `other:` 下打印其他物理和虚拟网卡 URL；网页不显示二维码。按 `Ctrl+C` 关闭服务。
+
+`--token <value>` 把目录、文件和上传 URL 固定到 `/<value>/` 下；遗漏或写错返回 `404`。令牌必须为 16 到 128 个 ASCII 字母、数字、`-` 或 `_`。`--path <目录>` 指定网页上传文件直接写入的目录；相对路径按启动目录解析，首次上传才创建目录，未指定时写入启动目录下的 `./ii/`。`-p` 不适用于 `ii web`，仍仅用于 WebDAV、FTP、SFTP 的便携 ticket。
+
 ## `ii recv`
 
 ### 用法

ii.md

@@ -10,6 +10,7 @@ pub struct Cli {
 #[derive(Debug)]
 pub enum Command {
     Send(SendArgs),
+    Web(WebArgs),
     Recv(RecvArgs),
     Relay(RelayArgs),
     Doctor,
@@ -31,13 +32,21 @@ pub struct SendArgs {
     pub sftp: bool,
     pub web: bool,
     pub web_token: Option<String>,
+    pub web_upload_dir: Option<PathBuf>,
     pub portable_webdav: bool,
     pub local: bool,
     pub relay: Option<iroh::RelayUrl>,
     pub accept_self_signed_relay: bool,
     pub no_relay: bool,
 }
 
+#[derive(Debug, Clone, Default)]
+pub struct WebArgs {
+    pub dir: Option<PathBuf>,
+    pub web_token: Option<String>,
+    pub web_upload_dir: Option<PathBuf>,
+}
+
 #[derive(Debug, Clone)]
 pub struct RecvArgs {
     pub ticket: String,
@@ -137,6 +146,7 @@ where
     let rest = args.split_off(1);
     let command = match command.as_str() {
         "send" => Command::Send(parse_send(rest)?),
+        "web" => Command::Web(parse_web(rest)?),
         "recv" => Command::Recv(parse_recv(rest)?),
         "relay" => Command::Relay(parse_relay(rest)?),
         "doctor" => reject_extra("doctor", rest).map(|_| Command::Doctor)?,
@@ -158,6 +168,7 @@ fn parse_send(args: Vec<String>) -> Result<SendArgs, ParseAction> {
             Some(("profile", value)) => out.profile = Some(value.to_string()),
             Some(("relay", value)) => out.relay = Some(parse_relay_url(value)?),
             Some(("token", value)) => out.web_token = Some(value.to_string()),
+            Some(("path", value)) => out.web_upload_dir = Some(PathBuf::from(value)),
             Some((flag, _)) => {
                 return Err(ParseAction::error(format!("unknown option `--{flag}`")));
             }
@@ -175,6 +186,7 @@ fn parse_send(args: Vec<String>) -> Result<SendArgs, ParseAction> {
                 "--sftp" => out.sftp = true,
                 "--web" => out.web = true,
                 "--token" => out.web_token = Some(iter.value("--token")?),
+                "--path" => out.web_upload_dir = Some(PathBuf::from(iter.value("--path")?)),
                 "-p" => out.portable_webdav = true,
                 "--local" => out.local = true,
                 "--relay" => out.relay = Some(parse_relay_url(&iter.value("--relay")?)?),
@@ -196,6 +208,44 @@ fn parse_send(args: Vec<String>) -> Result<SendArgs, ParseAction> {
     Ok(out)
 }
 
+fn parse_web(args: Vec<String>) -> Result<WebArgs, ParseAction> {
+    let mut out = WebArgs::default();
+    let mut iter = ArgsIter::new(args);
+
+    while let Some(arg) = iter.next() {
+        match split_long_value(&arg) {
+            Some(("token", value)) => out.web_token = Some(value.to_string()),
+            Some(("path", value)) => out.web_upload_dir = Some(PathBuf::from(value)),
+            Some((flag, _)) => {
+                return Err(ParseAction::error(format!("unknown option `--{flag}`")));
+            }
+            None => match arg.as_str() {
+                "-h" | "--help" => return Err(ParseAction::help(WEB_HELP)),
+                "--token" => out.web_token = Some(iter.value("--token")?),
+                "--path" => out.web_upload_dir = Some(PathBuf::from(iter.value("--path")?)),
+                _ if arg.starts_with('-') => {
+                    return Err(ParseAction::error(format!("unknown option `{arg}`")));
+                }
+                _ => {
+                    if out.dir.replace(PathBuf::from(&arg)).is_some() {
+                        return Err(ParseAction::error("web accepts only one directory"));
+                    }
+                }
+            },
+        }
+    }
+
+    if let Some(token) = out.web_token.as_deref()
+        && !is_valid_web_token(token)
+    {
+        return Err(ParseAction::error(
+            "--token must contain 16 to 128 ASCII letters, digits, '-' or '_'",
+        ));
+    }
+
+    Ok(out)
+}
+
 fn parse_recv(args: Vec<String>) -> Result<RecvArgs, ParseAction> {
     let mut ticket = None;
     let mut out_dir = None;
@@ -350,6 +400,9 @@ fn validate_send(args: &SendArgs) -> Result<(), ParseAction> {
     if args.web_token.is_some() && !args.web {
         return Err(ParseAction::error("--token requires --web"));
     }
+    if args.web_upload_dir.is_some() && !args.web {
+        return Err(ParseAction::error("--path requires --web"));
+    }
     if let Some(token) = args.web_token.as_deref()
         && !is_valid_web_token(token)
     {
@@ -473,6 +526,7 @@ ii file transfer
 
 Usage:
   ii send [options] [path]
+  ii web [directory] [--token <value>] [--path <dir>]
   ii recv [options] <ticket>
   ii relay [options]
   ii doctor
@@ -494,6 +548,7 @@ Options:
   --sftp
   --web
   --token <value>
+  --path <dir>
   -p
   -d
   --profile <name>
@@ -503,6 +558,15 @@ Options:
   --no-relay
 ";
 
+const WEB_HELP: &str = "\
+Usage:
+  ii web [directory] [--token <value>] [--path <dir>]
+
+Options:
+  --token <value>
+  --path <dir>
+";
+
 const RECV_HELP: &str = "\
 Usage:
   ii recv [options] <ticket>
@@ -646,6 +710,67 @@ mod tests {
         }
     }
 
+    #[test]
+    fn send_accepts_web_upload_path() {
+        for args in [
+            vec!["ii", "send", "file.txt", "--web", "--path", "uploads"],
+            vec!["ii", "send", "file.txt", "--web", "--path=uploads"],
+        ] {
+            let cli = Cli::parse_from(args);
+            match cli.command {
+                Command::Send(args) => {
+                    assert_eq!(args.web_upload_dir, Some(PathBuf::from("uploads")));
+                }
+                _ => panic!("expected send command"),
+            }
+        }
+    }
+
+    #[test]
+    fn web_accepts_directory_token_and_upload_path() {
+        let token = "A1b2C3d4E5f6G7h8";
+        for args in [
+            vec!["ii", "web"],
+            vec!["ii", "web", "shared", "--token", token, "--path", "uploads"],
+            vec![
+                "ii",
+                "web",
+                "shared",
+                "--token=A1b2C3d4E5f6G7h8",
+                "--path=uploads",
+            ],
+        ] {
+            let cli = Cli::parse_from(args);
+            match cli.command {
+                Command::Web(args) => {
+                    if args.dir.is_some() {
+                        assert_eq!(args.dir, Some(PathBuf::from("shared")));
+                        assert_eq!(args.web_token.as_deref(), Some(token));
+                        assert_eq!(args.web_upload_dir, Some(PathBuf::from("uploads")));
+                    }
+                }
+                _ => panic!("expected web command"),
+            }
+        }
+    }
+
+    #[test]
+    fn web_rejects_invalid_options_and_multiple_directories() {
+        for args in [
+            vec!["ii", "web", "first", "second"],
+            vec!["ii", "web", "-p"],
+            vec!["ii", "web", "--token", "too-short"],
+            vec!["ii", "web", "--token", "A1b2C3d4E5f6G7h!"],
+            vec!["ii", "web", "--token"],
+            vec!["ii", "web", "--path"],
+        ] {
+            assert!(matches!(
+                parse_args(args),
+                Err(ParseAction::Print { code: 2, .. })
+            ));
+        }
+    }
+
     #[test]
     fn web_token_accepts_hyphen_and_underscore() {
         assert!(is_valid_web_token("A1b2C3d4E5f6G_-h"));
@@ -681,6 +806,14 @@ mod tests {
         }
     }
 
+    #[test]
+    fn send_rejects_web_upload_path_without_web() {
+        assert!(matches!(
+            parse_args(["ii", "send", "file.txt", "--path", "uploads"]),
+            Err(ParseAction::Print { code: 2, .. })
+        ));
+    }
+
     #[test]
     fn send_accepts_ftp_and_sftp_storage_options() {
         let ftp = Cli::parse_from(["ii", "send", "--ftp", "-p", "-d", "file.txt"]);