tabby-tftp 0.2.2 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -13
- package/README.zh-CN.md +22 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,6 +10,27 @@
|
|
|
10
10
|
|
|
11
11
|
> TFTP has no authentication or encryption. Use it only on a trusted, isolated network.
|
|
12
12
|
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
### From Tabby Plugin Manager (recommended)
|
|
16
|
+
|
|
17
|
+
1. Go to Tabby **Settings** -> **Plugins**.
|
|
18
|
+
2. Switch to the **Available** tab.
|
|
19
|
+
3. Search for `tabby-tftp` and click **Install**.
|
|
20
|
+
4. Restart Tabby.
|
|
21
|
+
|
|
22
|
+
### Manual Installation via NPM
|
|
23
|
+
|
|
24
|
+
If you prefer to install it manually:
|
|
25
|
+
|
|
26
|
+
```powershell
|
|
27
|
+
cd "$env:APPDATA\tabby\plugins"
|
|
28
|
+
npm install tabby-tftp
|
|
29
|
+
```
|
|
30
|
+
*(On Linux/macOS, use `~/.config/tabby/plugins` or `~/Library/Application Support/tabby/plugins`)*
|
|
31
|
+
|
|
32
|
+
Restart Tabby after installation.
|
|
33
|
+
|
|
13
34
|
## Serial-console firmware workflow
|
|
14
35
|
|
|
15
36
|
1. Open **TFTP File Transfer** from Tabby's toolbar.
|
|
@@ -24,6 +45,10 @@ The server is intentionally read-only: devices can download files from the selec
|
|
|
24
45
|
|
|
25
46
|
Use the **TFTP Client** tab to upload or download a file. The default port is `69`. A download requires a remote filename; for an upload, leaving the remote filename empty uses the local filename.
|
|
26
47
|
|
|
48
|
+
## Security notes
|
|
49
|
+
|
|
50
|
+
The server protects against path traversal and only serves regular files below the configured root directory. UDP port 69 and the negotiated transfer port must be allowed by the local firewall. See [SECURITY.md](SECURITY.md) for reporting security issues.
|
|
51
|
+
|
|
27
52
|
## Development
|
|
28
53
|
|
|
29
54
|
Requirements: Node.js 18 or newer and a Tabby-compatible Angular/toolchain environment.
|
|
@@ -36,19 +61,6 @@ npm run pack:plugin
|
|
|
36
61
|
|
|
37
62
|
`npm run verify` runs type checking, protocol/server tests, and the production bundle. The installable package is generated by `npm pack`.
|
|
38
63
|
|
|
39
|
-
## Local installation
|
|
40
|
-
|
|
41
|
-
Close Tabby, then install the generated `.tgz` into Tabby's user plugin directory and restart Tabby:
|
|
42
|
-
|
|
43
|
-
```powershell
|
|
44
|
-
cd "$env:APPDATA\tabby\plugins"
|
|
45
|
-
npm install C:\path\to\tabby-tftp-0.2.1.tgz --legacy-peer-deps
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
## Security notes
|
|
49
|
-
|
|
50
|
-
The server protects against path traversal and only serves regular files below the configured root directory. UDP port 69 and the negotiated transfer port must be allowed by the local firewall. See [SECURITY.md](SECURITY.md) for reporting security issues.
|
|
51
|
-
|
|
52
64
|
## Contributing and publishing
|
|
53
65
|
|
|
54
66
|
See [CONTRIBUTING.md](CONTRIBUTING.md), [CHANGELOG.md](CHANGELOG.md), and [docs/PUBLISHING.md](docs/PUBLISHING.md).
|
package/README.zh-CN.md
CHANGED
|
@@ -10,6 +10,27 @@
|
|
|
10
10
|
|
|
11
11
|
> TFTP 没有身份认证和加密功能,只应在可信、隔离的局域网中使用。
|
|
12
12
|
|
|
13
|
+
## 安装方法
|
|
14
|
+
|
|
15
|
+
### 从 Tabby 插件市场安装(推荐)
|
|
16
|
+
|
|
17
|
+
1. 打开 Tabby **Settings (设置)** -> **Plugins (插件)**。
|
|
18
|
+
2. 切换到 **Available (可用)** 标签页。
|
|
19
|
+
3. 搜索 `tabby-tftp`,点击 **Install (安装)**。
|
|
20
|
+
4. 重启 Tabby。
|
|
21
|
+
|
|
22
|
+
### 通过 NPM 命令行手动安装
|
|
23
|
+
|
|
24
|
+
如果你更喜欢手动安装:
|
|
25
|
+
|
|
26
|
+
```powershell
|
|
27
|
+
cd "$env:APPDATA\tabby\plugins"
|
|
28
|
+
npm install tabby-tftp
|
|
29
|
+
```
|
|
30
|
+
*(如果是 Linux/macOS,路径通常为 `~/.config/tabby/plugins` 或 `~/Library/Application Support/tabby/plugins`)*
|
|
31
|
+
|
|
32
|
+
安装后请重启 Tabby。
|
|
33
|
+
|
|
13
34
|
## 串口烧录流程
|
|
14
35
|
|
|
15
36
|
1. 从 Tabby 工具栏打开 **TFTP 文件传输**。
|
|
@@ -20,7 +41,7 @@
|
|
|
20
41
|
|
|
21
42
|
服务端是只读的:设备可以下载根目录中的文件,但不能向电脑上传或覆盖文件。
|
|
22
43
|
|
|
23
|
-
## 本地构建与测试
|
|
44
|
+
## 本地构建与测试 (开发指南)
|
|
24
45
|
|
|
25
46
|
需要 Node.js 18 或更高版本。
|
|
26
47
|
|
|
@@ -32,15 +53,6 @@ npm run pack:plugin
|
|
|
32
53
|
|
|
33
54
|
`npm run verify` 会执行类型检查、协议/服务端测试和生产构建。
|
|
34
55
|
|
|
35
|
-
## 本地安装
|
|
36
|
-
|
|
37
|
-
关闭 Tabby,在 Tabby 用户插件目录中安装生成的 `.tgz` 包,然后重新启动 Tabby:
|
|
38
|
-
|
|
39
|
-
```powershell
|
|
40
|
-
cd "$env:APPDATA\tabby\plugins"
|
|
41
|
-
npm install C:\path\to\tabby-tftp-0.2.1.tgz --legacy-peer-deps
|
|
42
|
-
```
|
|
43
|
-
|
|
44
56
|
## 参与贡献与发布
|
|
45
57
|
|
|
46
58
|
参见 [CONTRIBUTING.md](CONTRIBUTING.md)、[CHANGELOG.md](CHANGELOG.md) 和 [docs/PUBLISHING.md](docs/PUBLISHING.md)。
|