Linux 命令速查手册网站 jaywcjlove/linux-command 离线部署方式详解

本文博主介绍一个GitHub 仓库jaywcjlove/linux-command，这是一个收集了600+ Linux 命令的开源项目，提供命令的 Markdown 文档、Web 界面、API 接口及多种部署方式。以下重点介绍其部署步骤，涵盖所有官方支持的部署方法：

---

🚀 部署方式概览

该项目支持以下主流部署方式：

1. Docker 部署
2. Vercel 一键部署
3. Netlify 一键部署
4. 宝塔面板（BT Panel）部署
5. 1Panel 面板部署
6. 手动静态网站部署（gh-pages 分支）

---

1️⃣ Docker 部署（最推荐）

适用于任何支持 Docker 的 Linux/Windows/macOS 主机。

步骤：

# 拉取镜像dockerpull wcjiang/linux-command# 启动容器（端口映射到主机 9665）dockerrun --name linux-command --rm -d -p9665:3000 wcjiang/linux-command:latest

或使用交互式后台运行（等效）：

dockerrun --name linux-command -itd -p9665:3000 wcjiang/linux-command:latest

访问地址：

http://localhost:9665/

✅优点：简单、跨平台、无需配置环境。

---

2️⃣ Vercel 一键部署

适合快速上线公网可访问的 Web 版本。

步骤：

• 点击项目 README 中的Deploy with Vercel按钮。
• 登录 Vercel 账号，确认部署。
• 自动构建并分配*.vercel.app域名。

✅优点：全自动 CI/CD，免费，带 HTTPS。

---

3️⃣ Netlify 一键部署

类似 Vercel，适合偏好 Netlify 的用户。

步骤：

• 点击Deploy to Netlify。
• 授权 GitHub，选择仓库，点击部署。
• 自动分配*.netlify.app域名。

✅优点：同样全自动，支持自定义域名 + HTTPS。

---

4️⃣ 宝塔面板（BT Panel）部署

适用于已安装宝塔面板 ≥ 9.2.0的服务器。

步骤：

1. 登录宝塔 → 左侧菜单Docker（首次需安装 Docker 和 Docker Compose）。
2. 进入Docker → 应用商店 → 实用工具，搜索linux-command。
3. 点击安装，填写配置：
   • 名称：默认linuxcommand_xxx
   • 版本：latest
   • 域名：留空或填你的域名（如cmd.example.com）
   • ✅ 勾选允许外部访问（若用 IP+端口访问）
   • 端口：默认3000（可改，如6806）
4. 点击确定，等待 1–3 分钟初始化完成。

访问方式：

• 若绑定域名：http://cmd.example.com
• 若用 IP：http://<服务器IP>:6806

✅优点：图形化操作，适合不熟悉命令行的用户。

---

5️⃣ 1Panel 面板部署

适用于1Panel ≥ v1.10.32-lts用户。

步骤：

1. 登录 1Panel →应用商店 → 开发工具，搜索linux-command。
2. 点击安装，配置：
   • 名称：linux-command
   • 端口：默认40255
   • ✅ 勾选外部访问
3. 提交后等待安装完成（状态变为“已启动”）。
4. （可选）创建反向代理网站：
   • 域名：cmd.example.com
   • 代理地址：http://127.0.0.1:40255

访问方式：

• 域名访问：https://cmd.example.com
• 直接 IP：http://<IP>:40255

✅优点：现代化面板，集成 OpenResty 反向代理。

---

6️⃣ 手动部署静态网站（高级用户）

适合想完全自定义或离线使用的场景。

方法一：克隆 gh-pages 分支

gitclone -b gh-pages https://github.com/jaywcjlove/linux-command.gitcdlinux-command# 将整个目录放入 Nginx / Apache / Caddy 的静态目录即可

方法二：使用原始 Markdown 生成 HTML

• 命令文档位于/command目录（均为.md文件）。
• 可自行用静态站点生成器（如 Hugo、Jekyll）渲染。

💡 项目也提供 JSON 索引：
https://raw.githubusercontent.com/jaywcjlove/linux-command/master/dist/data.json

✅优点：完全可控，无依赖，可嵌入其他系统。

---

🔒 注意事项

• Gitee 镜像站（jaywcjlove.gitee.io）因内容合规问题可能不可用（见 #283）。
• 项目为MIT 协议，可自由使用、修改、部署，无需保留作者信息（但鼓励保留以方便社区维护）。
• 国内访问 GitHub Pages 可能较慢，建议使用官方列出的 国内镜像站，如：
  • https://command.iced.eu.org/
  • https://linux.ykkit.cn/
  • https://linux.zanglikun.com/

---

✅ 总结：如何选择部署方式？

场景	推荐方式
快速本地测试	Docker
公网分享（免运维）	Vercel / Netlify
已有宝塔面板	宝塔应用商店
已有 1Panel	1Panel 应用商店
完全自定义 / 内网部署	手动部署 gh-pages

该项目部署极其灵活，几乎覆盖所有现代 DevOps 场景，非常适合搭建个人或团队的 Linux 命令速查手册。