Civil-X Dev Environment Architecture v21

agent-hub-dev · Ubuntu 24.04

Single-host Runtime Domain

One Ubuntu host running delivery, application services, infrastructure, and backup.

Access & Delivery

Core Runtime

Data & Backup

User Browser

HTTPS access

:56789

CNB Git

CI/CD pipeline

CI/CD

Client Terminal

development / ops

nginx

reverse proxy

civil-x-bff

API gateway

:4091

civil-x-opencode

LLM runtime

:4098

agent-hub-platform

auth · sessions · files

:4080

MCP Tools

protocol

parse

rag

fea

PostgreSQL

metadata / sessions

pgvector

MinIO

object storage

civil-x

Nacos v3

config center

:18080

NAS MinIO

backup target

bak

Reading Guide

Request Path

Browser → nginx → BFF → Platform

Agent Path

BFF → OpenCode runtime

MCP Tools

OpenCode → parse / rag / fea tools

Data Path

Platform stores metadata in PostgreSQL and files in MinIO

Config Path

Nacos provides runtime service configuration

Backup Path

cron exports PostgreSQL backups to NAS MinIO

Security

SSH public key only; WAF is planned

Host Utilities

mihomo :7890

cron · 2AM

SSH · pubkey

Redis planned

WAF planned

Architecture Notes

Single-host Compose deployment
Nacos-driven runtime configuration
MCP tools decoupled from agent runtime

v21