---
id: vibe-kanban-opencode-ubuntu-guide
title: "Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南"
type: source
tags: [npm, npx, pm2, ubuntu, vibe-coding, vibe-kanban]
sources: []
last_updated: 2026-04-14
---

## Summary
- 核心主题：Ubuntu Server 环境下 Vibe-Kanban 与 OpenCode 的完整安装与进程管理
- 问题域：AI 编码 Agent 的本地化部署与运维管理
- 方法/机制：通过 nvm 安装 Node 20，使用 pm2 管理进程，确保非 root 用户权限正确
- 结论/价值：提供可复用的生产环境部署指南

## Key Claims
- Vibe-Kanban 和 OpenCode 必须以非 root 用户运行，避免权限问题
- Node 版本必须使用 20，兼容最新工具链
- pm2 可实现进程自动重启和开机自启
- `/var/tmp/vibe-kanban` 和 `~/.vibe-kanban` 目录权限必须属于运行用户

## Key Concepts
- [[Vibe-Kanban]]：AI 编码 Agent 任务看板，支持多 Agent 协作
- [[OpenCode]]：开源 AI 编码 Agent，提供终端界面和桌面应用
- [[PM2]]：Node.js 进程管理器，支持进程守护和负载均衡
- [[nvm]]：Node.js 版本管理器，支持多版本共存
- [[Node-js]]：JavaScript 运行时环境

## Key Entities
- [[BloopAI]]：Vibe-Kanban 背后的公司，提供开源 AI 编码工具

## Connections
- [[Vibe-Kanban]] ← 安装依赖 ← [[Node-js]]
- [[OpenCode]] ← 安装依赖 ← [[Node-js]]
- [[Vibe-Kanban]] ← 使用 ← [[PM2]]
- [[Node-js]] ← 安装工具 ← [[nvm]]

## Contradictions