Swagger Editor 离线安装答案

【问题标题】：Swagger Editor offline installationSwagger Editor 离线安装
【发布时间】：2023-03-26 16:57:01
【问题描述】：

我们公司正在使用 swagger 来记录他们的 API，目前一些开发人员正在他们的 PC 上使用在线 swagger 编辑器。

我想将这部分设计过程转移到我们的标准开发环境中，该环境位于没有互联网接入的围墙花园中。

如何在离线环境中安装 npm 和 swagger 编辑器？

可以选择使用 RHEL 或 Windows 机器，但最好使用 Windows，因为开发人员拥有本地管理员权限

【问题讨论】：

【解决方案1】：

简而言之是https://swagger.io/docs/swagger-tools/#swagger-editor

git clone https://github.com/swagger-api/swagger-editor.git
cd swagger-editor
npm install
npm run build
npm start

它可以在您的 Intranet 中运行。

【讨论】：

【解决方案2】：

npm不是必须的，你可以从Swagger Editor repository下载编译好的文件：

并在本地（从文件系统）打开 index.html 或将文件放到网络中的 Web 服务器上。

【讨论】：

是的，它也可以作为静态文件使用。有一些限制，但我不记得了。
谢谢 - 我现在就试试这个。以这种方式运行时是否具备全部功能？
@druidoodle 是的 - 自动完成、语法检查、UI 渲染、试用等。
@Helen - 谢谢。它可以工作，虽然不在 Chrome 中。我认为 Chrome 访问本地文件的本地存储存在一些问题，我会自己研究。
@druidoodle：尝试使用--allow-file-access-from-files 运行 Chrome。或者更好的是，运行本地 Web 服务器（例如，如果您使用 Windows，则为 IIS）并从那里运行编辑器。

【解决方案3】：

使用一个带有 npm/npx 的命令：

npx swagger-editor-binary

【讨论】：

【解决方案4】：

从 swagger-editor 的 github 页面下载其中一个源版本（单击页面上的版本链接）
解压下载的源发布 zip/tar 文件。
cd 到解压的源目录，输入“npm install”（或者如果你安装了一些 npm 镜像模块，例如 cnpm，请改用“cnpm install”）
使用浏览器打开源目录中的 index.html 文件。或者，按照official guide“使用来自 GitHub 的 http-server 模块设置”部分从本地静态 Web 服务器提供服务。

附言。除非您想按照官方文档的“贡献”部分中的说明进行贡献，否则您无需构建源代码。

【讨论】：