# @astralyn/sash 中文文档

规范地址：https://npmcn.com/package/%40astralyn/sash/

版本：0\.5\.3
npm 元数据更新时间：2026-11-06T11:58:27.146Z
中文译文更新时间：2026-11-07T06:31:29.887Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40astralyn/sash
原文对照：https://npmcn.com/package/%40astralyn/sash/?lang=original
项目主页：https://github.com/ming-kang/Sash#readme
源码仓库：https://github.com/ming-kang/Sash

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：16.6 MB，279 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.0\.0
- 运行依赖：0 个
- 首次发布：2026-09-05T04:49:06.230Z
- 最新版本发布：2026-11-06T11:58:26.840Z
- 近 30 天下载量：2038（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

一个网络工具箱,用于开发者,学习,和研究,其中包含一个命令行伴和内置的网络仪表板.

## 安装

```sh
npm install @astralyn/sash
```

也可以使用：`pnpm add @astralyn/sash`、`yarn add @astralyn/sash`、`bun add @astralyn/sash`

## README

# 萨什语Name

> 一个基于规则的网络核心的轻量级命令行伴和网络仪表板.

萨什是一个 **用于开发、学习和研究的网络工具箱**. 它在您的机器上安装,运行并维护一个基于规则的网络核心:本地的HTTP/SOCKS端点,由规则驱动的交通路由,远程配置管理,并通过内置的网络仪表板进行现场交通检查.

## 特征

-   **背景主管** – 端口每个数据文件夹有一个 Sash 进程 `19090`,管理核心生命周期,恢复和倒置代理
-   **零下载网络仪表板** - 内置Vue 3仪表板,与包件捆绑在 `http://127.0.0.1:19090/ui/`
-   **保存并重新装入** —— 选中的配置文件更改 重新装入健康的核心 ; 代理端口和局域网更改等待明确的应用
-   **Windows 桌面整合** ——带有快照和有条件恢复的系统代理,加上登录时开始(`sash auto`(中文(简体) )
-   **已验证的更新** ——完整性检查 核心下载回滚(`sash update`(三); `sash upgrade` 通过 npm 安装新的 Sash 并重新启动
-   **诊断** —— 说 `sash doctor [--json]` 检查安装、状态、端口和Windows集成,并提供维修建议
-   **证书卫生** ——儿童流程在被洗刷的环境中运行;回路流量从不穿越代理调度器

## 所需资源

-   节点.js **24个或较新**
-   Windows 10+ — x64 and arm64 (英语)

核心生命周期和本地端点可移植到macOS和Linux;系统-代理和登录-启动集成是仅Windows.

## 安装

```sh
npm install -g @astralyn/sash
sash --help
```

取自源检出 :

```sh
npm ci
npm run build
npm link
sash --help
```

`npm link` 安装本地构建的检出。 以 `npm unlink -g @astralyn/sash` 当完成.

## 快速启动

```sh
sash start                 # downloads Core if needed, launches Sash and Core
sash web                   # open and authorize the web dashboard
sash status                # runtime state, endpoints, and proxy status
sash stop                  # restores prior proxy state, stops Core and Sash
```

Core停止时,仪表板也起作用:先保存编辑,然后 **应用配置** (或 `sash restart`与它们一起重新启动 Core 。 见 [用户操作指南( O)](https://npmcn.com/package/%40astralyn/sash/docs/usage.md) 用于所有命令、更新和排除故障,以及 [自动启动](https://npmcn.com/package/%40astralyn/sash/docs/autostart.md) 页:1 `sash auto on`。 。 。 .

## 文档

-   [**用户操作指南( O)**](https://npmcn.com/package/%40astralyn/sash/docs/usage.md) ——CLI命令参考,配置,更新和排除出故障.
-   [**自动启动**](https://npmcn.com/package/%40astralyn/sash/docs/autostart.md) ——登录启动,注册状态和诊断.
-   [**后端架构**](https://npmcn.com/package/%40astralyn/sash/docs/backend.md) ——背景过程,本地API,生命周期和安全变化剂.
-   [**前端架构**](https://npmcn.com/package/%40astralyn/sash/docs/frontend.md) ——Vue 3仪表板,共享状态,API合同和流.
-   [**第三方通知**](https://npmcn.com/package/%40astralyn/sash/THIRD_PARTY_NOTICES.md) 捆绑的仪表板资产和运行时卸载的Core的许可证.

## 免责声明

Sash 是创建用于 **学习、研究和开发调试**它运行在您源代码和配置的服务器和配置文件上。 你负责如何使用,遵守你辖区的法律法规.

## 上游组件

Sash是麻省理工学院许可的开源软件和独立项目. 它不将上游 Core 捆绑在这个寄存器或 npm 包中; 在运行时它下载一个未修改的释放文物 [`MetaCubeX/mihomo`](https://github.com/MetaCubeX/mihomo)。上游工作源分支是 [`Meta`](https://github.com/MetaCubeX/mihomo/tree/Meta);许可证由选定的释放及其所附通知决定。 Sash目前测试的核心合同是 `v1.19.30`,其源标签带有 [GNU 通用公共许可证 v3. 0](https://github.com/MetaCubeX/mihomo/blob/v1.19.30/LICENSE)。 。 。 .

下载的部分仍然是各自作者的工作;所有信用都属于上游。 见 [第三方通知](https://npmcn.com/package/%40astralyn/sash/THIRD_PARTY_NOTICES.md) 用于捆绑的仪表板通知和特定发布 核心归属.

## 常见问题

### @astralyn/sash 是什么？

一个网络工具箱,用于开发者,学习,和研究,其中包含一个命令行伴和内置的网络仪表板\.

### 如何安装 @astralyn/sash？

在项目目录运行 npm install @astralyn/sash，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 sash，可以用 npx sash 直接运行。

### @astralyn/sash 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/astralyn\_\_sash 是否存在。

### @astralyn/sash 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @astralyn/sash 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @astralyn/sash 可以商用吗？

@astralyn/sash 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @astralyn/sash 的下载量有多少？

根据 npm 官方下载统计，@astralyn/sash 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,038 次，日均约 68 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @astralyn/sash 还在维护吗？

最新版本 0\.5\.3 发布于 2026/11/06（1 天前）；至今共发布 39 个版本，其中过去 12 个月发布了 39 个；首次发布于 2026/09/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。