---
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
- （暂无）
