Docker服务下添加Web UI，增删改查端点等，反代后可跨域、跨物理机、服务器使用 by ANIIAN91 · Pull Request #64 · lich0821/ccNexus

ANIIAN91 · 2025-12-15T10:32:45Z

webui

* resolve merge conflict in main.go, keep remote version * 已知问题修复1215 --------- Co-authored-by: hea7en <hea7enn@qq.com>

Copilot

Pull request overview

This pull request transforms ccNexus from a Wails desktop application into a headless HTTP service with Docker support and adds a comprehensive Web UI for management and monitoring. The version is bumped from 4.3.0 to 4.4.0.

Key Changes:

Headless Mode: New cmd/server/main.go entry point for running as a pure HTTP service without GUI
Docker Support: Complete containerization with Dockerfile, docker-compose.yml, and entrypoint script for easy deployment
Web UI: Embedded web-based admin dashboard for endpoint management, statistics, and real-time monitoring
API Improvements: Enhanced transformer support for function calling in OpenAI Responses, Gemini, and Claude APIs
Bug Fixes: PowerShell Core detection, UI styling improvements, and input token fallback for Claude transformers

Reviewed changes

Copilot reviewed 27 out of 27 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
docker-entrypoint.sh	Shell script for container initialization with data directory checks
docker-compose.yml	Docker Compose configuration for running ccNexus as a containerized service
Dockerfile	Multi-stage Docker build for headless server with SQLite support
README_DOCKER.md	Comprehensive documentation for Docker deployment and Web UI usage
app/cmd/server/main.go	New headless server entry point with environment variable support
app/cmd/server/webui_plugin.go	Plugin registration for Web UI routes
app/cmd/webui/*	Complete Web UI implementation with API handlers and frontend assets
app/internal/transformer/convert/*	Enhanced API transformations with function calling and thinking block support
app/internal/transformer/cc/claude.go	Added input tokens fallback for Claude message_delta events
app/internal/terminal/launcher.go	PowerShell Core (pwsh) detection for Windows terminal launching
app/internal/proxy/streaming.go	Updated streaming handler to pass request body for token estimation
app/frontend/src/*	UI improvements for model selection and theme support
app/wails.json	Version bump to 4.4.0

Comments suppressed due to low confidence (1)

Dockerfile:2

The Dockerfile references Golang version 1.24 which does not exist. As of January 2025, the latest stable Go version is 1.23. This will cause build failures. Consider using a valid version like golang:1.23-alpine or golang:1.22-alpine.

FROM golang:1.24-alpine AS builder

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-12-15T10:48:25Z

app/cmd/webui/ui/index.html

+    <!-- Chart.js from CDN -->
+    <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>


Loading Chart.js from a CDN creates a dependency on external infrastructure and can fail if the CDN is unavailable or blocked. For a headless Docker deployment, consider either bundling Chart.js locally or documenting this external dependency clearly in the README.

Suggested change



<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>



<script src="/ui/js/vendor/chart.umd.min.js"></script>

Copilot · 2025-12-15T10:48:26Z

app/cmd/webui/api/middleware.go

+// CORSMiddleware adds CORS headers to responses
+func CORSMiddleware(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		w.Header().Set("Access-Control-Allow-Origin", "*")


CORS is configured to allow all origins with "*". This is a security risk in production environments as it allows any website to make requests to the API. Consider restricting this to specific trusted origins or making it configurable via environment variables.

Copilot · 2025-12-15T10:48:26Z

app/cmd/webui/api/endpoints.go

+	if req.Model != "" {
+		existing.Model = req.Model
+	}


The Model field is only updated if req.Model is non-empty, but existing.Remark is always overwritten (line 224). This inconsistency means users cannot clear the Model field while they can clear the Remark field. Consider using the same pattern for both fields or allowing explicit clearing of the Model field.

Suggested change

if req.Model != "" {

existing.Model = req.Model

}

existing.Model = req.Model

Copilot · 2025-12-15T10:48:26Z

app/cmd/webui/ui/js/components/dashboard.js

+        new Chart(ctx, {
+            type: 'bar',
+            data: {
+                labels: endpoints,
+                datasets: [{
+                    label: 'Requests',
+                    data: requests,
+                    backgroundColor: '#3b82f6',
+                    borderColor: '#2563eb',
+                    borderWidth: 1
+                }]
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: true,
+                plugins: {
+                    legend: {
+                        display: false
+                    }
+                },
+                scales: {
+                    y: {
+                        beginAtZero: true
+                    }
+                }
+            }
+        });


Creating a new Chart instance without destroying any previous chart can lead to memory leaks if renderChart is called multiple times (e.g., when the dashboard is re-rendered). Consider storing the chart instance and destroying it before creating a new one using chart.destroy().

Copilot · 2025-12-15T10:48:26Z

app/cmd/webui/ui/js/components/dashboard.js

@@ -0,0 +1,177 @@
+import { api } from '../api.js';
+import { state } from '../state.js';


Unused import state.

Suggested change

import { state } from '../state.js';

Copilot · 2025-12-15T10:48:27Z

app/cmd/webui/ui/js/components/endpoints.js

@@ -0,0 +1,330 @@
+import { api } from '../api.js';
+import { state } from '../state.js';


Unused import state.

Suggested change

import { state } from '../state.js';

…artWithMux undefined 的编译错误（主程序需要在已有 mux 上挂载 WebUI 时使用）

root and others added 7 commits December 14, 2025 16:13

Convert ccNexus to headless Docker service

81075a3

fix：已知问题修复 (lich0821#63)

9de2b76

* resolve merge conflict in main.go, keep remote version * 已知问题修复1215 --------- Co-authored-by: hea7en <hea7enn@qq.com>

feat: adapt to cc 2.0.69

1748eb0

fix: add input_tokens in message_delta to support auto-compact

c49ce0b

v4.4.0

d7fc900

chore: add webui plugin under cmd

f7e8dcc

README_DOCKER.md

91bf488

Copilot AI review requested due to automatic review settings December 15, 2025 10:32

Copilot started reviewing on behalf of ANIIAN91 December 15, 2025 10:33 View session

Merge branch 'master' into docker-headless

7444e54

ANIIAN91 changed the title ~~Docker headless~~ Docker服务下添加Web UI，增删改查端点等 Dec 15, 2025

ANIIAN91 changed the title ~~Docker服务下添加Web UI，增删改查端点等~~ Docker服务下添加Web UI，增删改查端点等，反代后可跨域、跨物理机、服务器使用 Dec 15, 2025

Merge branch 'lich0821:master' into docker-headless

522bd4f

Copilot AI reviewed Dec 15, 2025

View reviewed changes

修复：在 app/internal/proxy/proxy.go 新增 StartWithMux 并让 Start 复用它，解决 p.St…

276c16e

…artWithMux undefined 的编译错误（主程序需要在已有 mux 上挂载 WebUI 时使用）

lich0821 merged commit 1ebe9cb into lich0821:master Dec 15, 2025
6 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

Docker服务下添加Web UI，增删改查端点等，反代后可跨域、跨物理机、服务器使用#64

Docker服务下添加Web UI，增删改查端点等，反代后可跨域、跨物理机、服务器使用#64
lich0821 merged 10 commits intolich0821:masterfrom
ANIIAN91:docker-headless

ANIIAN91 commented Dec 15, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Dec 15, 2025

Uh oh!

Copilot AI Dec 15, 2025

Uh oh!

Copilot AI Dec 15, 2025

Uh oh!

Copilot AI Dec 15, 2025

Uh oh!

Copilot AI Dec 15, 2025

Uh oh!

Copilot AI Dec 15, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		<!-- Chart.js from CDN -->
		<script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>

		@@ -0,0 +1,177 @@
		import { api } from '../api.js';
		import { state } from '../state.js';

		@@ -0,0 +1,330 @@
		import { api } from '../api.js';
		import { state } from '../state.js';

Comments

Conversation

ANIIAN91 commented Dec 15, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 15, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants