---
title: "TSLink v0.3.0：新安装默认启用主页网关"
description: "一次操作完成授权，网关与直接入口使用相同的人员和应用统计键；网关特有的安全检查仍有文档列出的例外；已有安装保留原模式。"
url: "https://tslink.md/zh/blog/tslink-v0-3-0"
locale: "zh"
product_version: "0.3.0"
source: "https://github.com/anydoor7/tslink/blob/v0.3.0/CHANGELOG.md"
---

> Documentation index: https://tslink.md/zh/llms.txt · Installed binary is authoritative: `tslink manifest`.

TSLink v0.3.0 新安装默认启用主页网关。Tailnet 之外的访问者接受一次设备共享后，你就能决定对方可以使用哪些路由私有应用。已有安装保留原模式，包括空 registry。私有 HTTP 和文件应用保留自己的节点和 URL，`--portal-only` 仍需明确指定。

## 一次操作完成授权

假设已注册名为 `photos` 的私有应用，用访问者实际的 Tailscale 登录账户执行：

```bash
tslink people add alice@example.com --apps photos --for 7d --print-links
```

TSLink 会核实成员身份、保留已有权限、准备路由并完成必要的邀请。创建邀请需要用户持有的 Tailscale API token。请自行发送生成的消息，并保管好其中的邀请链接，持有链接的人可以使用它。接收者仍需安装 Tailscale，网络策略也必须允许连接。设置未完成会返回错误并保留已完成的状态；等待接收者接受邀请表示 owner 已完成操作。

`people add` 新授权默认 24h。`add --allow` 和 `invite device` 保留永久默认，已有期限也会保留。明确指定 `never` 需要确认，设备邀请访客也可以获得永久授权。浏览器访客链接和 Funnel 仍须有期限。会到期的 MCP binding 和受限角色仍遵守期限限制，省略期限时为 24h。详见[人员分享](https://tslink.md/zh/docs/people-sharing.md)和[期限规则](https://tslink.md/zh/docs/durations.md)。

## 两个入口使用相同的人员和应用统计键

无论请求经过网关还是应用自身节点，访问总量都按人员和应用汇总。返回事件的条数限制不会缩减总量，非人员流量和 TCP 计数另列。两条路径对后端故障、访问拒绝和中断请求使用一致的访客响应；网关特有的安全检查仍保留文档列出的例外。记录受保留期限、丢弃和崩溃缺口限制，详见[访问记录](https://tslink.md/zh/docs/access-history.md)。

## 升级已有安装

```bash
brew upgrade --cask anydoor7/tap/tslink
# 如果 TSLink 作为后台服务运行：
tslink install
```

Scoop 用户先运行 `scoop update`，再运行 `scoop update tslink`；其他安装方式请下载新归档或软件包。已有安装保留原模式。要明确启用网关，请执行：

```bash
tslink portal enable --owner you@example.com --gateway
```

按提示完成入网后，检查 `tslink status --json`、`tslink doctor --json`，并从获准设备实际访问应用。网关状态使用 registry schema 3，使用旧版本前请遵循[降级步骤](https://tslink.md/zh/docs/portal-gateway.md#registry-schema-and-downgrade)。

本版还统一了访客错误响应，修复空设备邀请列表的处理，并在完成回执写入失败时保留原操作错误。发布二进制使用 Go 1.27.3，包含 X.509 修复，完整细节见[更新日志](https://tslink.md/changelog)。

TSLink 是独立项目，并非由 Tailscale 制作或背书。继续阅读 [TSLink v0.3.0 变更记录](https://github.com/anydoor7/tslink/blob/v0.3.0/CHANGELOG.md)和[安装指南](https://tslink.md/zh/docs/installation.md)。

[Markdown 版本](https://tslink.md/zh/blog/tslink-v0-3-0.md)。