Auto-sync: 2026-04-17 08:37

wiki/sources/vibe-kanban-opencode-ubuntu-server-installation-guide.md

@@ -0,0 +1,48 @@
+---
+title: "Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南"
+type: source
+tags: [npm, npx, pm2, ubuntu, vibe-coding, vibe-kanban]
+date: 2026-04-17
+---
+
+## Source File
+- [[raw/Vibe Coding/Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南.md]]
+
+## Summary
+- 核心主题：在 Ubuntu Server 上使用非 root 用户（shenwei）安装和管理 Vibe-Kanban 与 OpenCode
+- 问题域：Node 环境配置、进程管理、远程开发工具部署
+- 方法/机制：使用 nvm 安装 Node 20、npm 全局安装工具、pm2 进程管理
+- 结论/价值：提供完整的 Vibe-Kanban + OpenCode 环境搭建指南，包含验证步骤和故障排查
+
+## Key Claims
+- 使用 nvm 安装 Node 20 可避免权限问题和版本冲突
+- Vibe-Kanban 会自动 spawn OpenCode executor，无需手动启动
+- pm2 可有效管理 Vibe-Kanban 进程并实现开机自启
+- 不要使用 root 用户启动 OpenCode serve，否则会导致权限问题
+
+## Key Quotes
+> "不要用 root 启动 OpenCode serve，vibe-kanban 会自动 spawn executor" — 安装注意事项
+> "vibe-kanban 自行 spawn executor，随机端口即可" — 进程管理总结
+> "pm2 只管理 vibe-kanban，executor 随进程一起管理" — 架构说明
+
+## Key Concepts
+- [[nvm]]：Node 版本管理器，用于安装和管理 Node.js 多版本环境
+- [[npm]]：Node 包管理器，用于安装和管理 JavaScript/Node.js 包
+- [[npx]]：Node 包执行工具，无需全局安装即可运行 npm 包
+- [[pm2]]：Node 进程管理器，提供进程守护、日志管理和负载均衡功能
+- [[Vibe Coding]]：AI 辅助开发方式，自然语言描述需求，AI 负责代码实现
+
+## Key Entities
+- [[Vibe-Kanban]]：AI Agent 管理工具，支持 Vibe Coding 工作流
+- [[OpenCode]]：开源 AI 编程助手，提供终端/桌面/IDE 三种使用形态
+- [[shenwei]]：Ubuntu Server 非 root 用户，用于安全运行服务
+
+## Connections
+- [[Vibe-Kanban]] ← spawns ← [[OpenCode]]
+- [[npm]] ← installs ← [[Vibe-Kanban]]
+- [[npm]] ← installs ← [[OpenCode]]
+- [[pm2]] ← manages ← [[Vibe-Kanban]]
+- [[nvm]] ← provides ← [[Node-js]]
+
+## Contradictions
+- （暂无）