Swagger编辑器离线安装

Question

我们公司正在使用 Swagger 来文档化他们的 API。目前，一些开发者正在使用在线 Swagger 编辑器在他们的电脑上工作。

我想把这个设计过程的一部分转移到我们的标准开发环境中，该环境是一个没有网络访问权限的封闭式环境。

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

可以选择使用 RHEL 或 Windows 机器，但由于开发人员拥有本地管理员权限，因此Windows更可取。

- druidoodle

Answer 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

它将在您的内部网络中正常工作。

- Akzhan Abdulin

---

以上不需要互联网访问吗？ - druidoodle

不需要引导后联网。 - Akzhan Abdulin

这实际上是最好的解决方案。事实上，我尝试了Node 11.2.0，但它并没有立即起作用，然后切换到6.14.0，它就像魔法一样工作了！ - Hugo Tavares

Answer 2

npm 不是必需的，您可以从 Swagger 编辑器存储库 下载编译好的文件：

• index.html
• dist\*

然后在本地打开 index.html (从文件系统中) 或者将这些文件放到您网络中的一个 Web 服务器上。

- Helen

---

是的，它也可以作为静态文件工作。但有一些限制，但我不记得了。 - Akzhan Abdulin

谢谢 - 我现在会尝试。以这种方式运行时，它是否具有完整的功能？ - druidoodle

@druidoodle 是的 - 自动完成、语法检查、UI 渲染、试用等。 - Helen

@Helen - 谢谢你。它可以工作，但在Chrome中不行。我认为在Chrome中访问本地文件的本地存储存在一些问题，我会自己研究一下。 - druidoodle

@druidoodle：尝试使用--allow-file-access-from-files在Chrome中运行。或者更好的方法是，运行一个本地Web服务器（例如，如果您使用Windows，则使用IIS），然后从那里运行Editor。 - Helen

Answer 3

使用npm/npx中的一个命令：

npx swagger-editor-binary

- user3352495

Answer 4

1. 从swagger-editor的github页面下载其中一个源代码发布版（点击页面上的“releases”链接）
2. 解压下载的源代码发布版zip/tar文件。
3. 进入提取的源目录，输入“npm install”（或者如果您安装了一些npm镜像模块，例如cnpm，则使用“cnpm install”）
4. 使用浏览器打开源目录中的index.html文件。或者，按照官方指南中的“使用来自GitHub的http-server模块设置”部分，从本地静态Web服务器提供服务。

PS. 除非您想在官方文档的“贡献”部分中进行贡献，否则无需构建源代码。

- Yufeng Lan