tkmind/memind
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity

Add local test domain setup (test.*.tkmind.cn).

Browse Source 
DNS/TLS/proxy scripts and docs/local-dev.md replace localhost URLs for H5, memind_adm, Plaza, and Ops during local dev.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
john
2026-06-17 09:55:04 +08:00
parent 67348db026
commit 54de1dd8e3
15 changed files with 908 additions and 105 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/dev.mjs
+80 -82
View File
@@ -7,28 +7,6 @@ import path from 'node:path';
import { fileURLToPath } from 'node:url';
const root = path.join(path.dirname(fileURLToPath(import.meta.url)), '..');
const plazaDir = process.env.PLAZA_APP_DIR ?? path.join(root, '../tkmind_go/ui/plaza');
const opsDir = path.join(root, 'ops');
const portalPort = Number(process.env.H5_PORT ?? 8081);
const vitePort = Number(process.env.VITE_PORT ?? 5173);
const plazaPort = Number(process.env.PLAZA_PORT ?? 3001);
const opsPort = Number(process.env.OPS_PORT ?? 3002);
const adminPort = Number(process.env.ADMIN_PORT ?? 8082);
const portalUrl = `http://127.0.0.1:${portalPort}`;
const adminUrl = `http://127.0.0.1:${adminPort}`;
const plazaHost = process.env.PLAZA_LOCAL_HOST ?? 'plaza.tkmind.cn';
const plazaPublicPort = Number(process.env.PLAZA_PUBLIC_PORT ?? 443);
const plazaPublicScheme = String(process.env.PLAZA_PUBLIC_BASE ?? 'https://plaza.tkmind.cn').startsWith('http://')
? 'http'
: 'https';
const plazaPublicBase = (
process.env.PLAZA_PUBLIC_BASE ??
(plazaPublicPort === 80 || plazaPublicPort === 443
? `${plazaPublicScheme}://${plazaHost}`
: `${plazaPublicScheme}://${plazaHost}:${plazaPublicPort}`)
).replace(/\/$/, '');
const plazaUrl = plazaPublicBase;
const opsUrl = `http://127.0.0.1:${opsPort}`;
function loadEnvFile(filePath) {
if (!fs.existsSync(filePath)) return;
@@ -46,6 +24,28 @@ function loadEnvFile(filePath) {
loadEnvFile(path.join(root, '../../.env.local'));
loadEnvFile(path.join(root, '.env'));
const {
ADMIN_HOST,
allHostsConfigured,
DNS_PORT,
H5_HOST,
H5_PUBLIC_BASE,
OPS_HOST,
PLAZA_HOST,
PLAZA_PUBLIC_BASE,
publicUrl,
} = await import('./local-test-config.mjs');
const plazaDir = process.env.PLAZA_APP_DIR ?? path.join(root, '../tkmind_go/ui/plaza');
const opsDir = path.join(root, 'ops');
const portalPort = Number(process.env.H5_PORT ?? 8081);
const vitePort = Number(process.env.VITE_PORT ?? 5173);
const plazaPort = Number(process.env.PLAZA_PORT ?? 3001);
const opsPort = Number(process.env.OPS_PORT ?? 3002);
const adminPort = Number(process.env.ADMIN_PORT ?? 8082);
const portalUrl = `http://127.0.0.1:${portalPort}`;
const adminUrl = `http://127.0.0.1:${adminPort}`;
function freePort(port) {
try {
execSync(`lsof -ti TCP:${port} -sTCP:LISTEN | xargs kill -9`, { stdio: 'ignore' });
@@ -73,7 +73,8 @@ function spawnChild(command, args, label, cwd = root, extraEnv = {}) {
let server;
let admin;
let plaza;
let plazaProxy;
let localProxy;
let dnsServer;
let ops;
let vite;
let stopping = false;
@@ -84,7 +85,8 @@ function shutdown(code = 0) {
server?.kill('SIGTERM');
admin?.kill('SIGTERM');
plaza?.kill('SIGTERM');
plazaProxy?.kill('SIGTERM');
localProxy?.kill('SIGTERM');
dnsServer?.kill('SIGTERM');
ops?.kill('SIGTERM');
vite?.kill('SIGTERM');
setTimeout(() => process.exit(code), 300);
@@ -105,30 +107,27 @@ async function waitFor(url, check, label, retries = 60) {
throw new Error(`${label} 未在 ${url} 启动`);
}
const mindSpacePublicBase = (
process.env.H5_PUBLIC_BASE_URL ?? `http://localhost:${vitePort}`
).replace(/\/$/, '');
const mindSpacePublicBase = H5_PUBLIC_BASE;
const plazaEnv = {
PLAZA_API_PROXY: portalUrl,
PLAZA_API_BASE: portalUrl,
PLAZA_PUBLIC_BASE: plazaPublicBase,
NEXT_PUBLIC_API_BASE: plazaPublicBase,
NEXT_PUBLIC_SITE_BASE: plazaPublicBase,
PLAZA_PUBLIC_BASE: PLAZA_PUBLIC_BASE,
NEXT_PUBLIC_API_BASE: PLAZA_PUBLIC_BASE,
NEXT_PUBLIC_SITE_BASE: PLAZA_PUBLIC_BASE,
NEXT_PUBLIC_MINDSPACE_BASE: mindSpacePublicBase,
NEXT_PUBLIC_PLAZA_BASE: '/plaza',
};
const viteEnv = {
VITE_PLAZA_BASE: plazaPublicBase,
VITE_PLAZA_BASE: PLAZA_PUBLIC_BASE,
VITE_MINDSPACE_BASE: mindSpacePublicBase,
};
const opsEnv = {
// /auth (login/session) stays on the public portal; /api (ops console) hits memind_adm.
OPS_API_PROXY: portalUrl,
OPS_ADMIN_PROXY: adminUrl,
VITE_PLAZA_BASE: plazaPublicBase,
VITE_PLAZA_BASE: PLAZA_PUBLIC_BASE,
VITE_MINDSPACE_BASE: mindSpacePublicBase,
};
@@ -138,8 +137,8 @@ function ensurePlazaApp() {
}
}
function plazaPublicReachable() {
const url = new URL(`${plazaPublicBase}/plaza`);
function publicReachable(urlString) {
const url = new URL(urlString);
const isHttps = url.protocol === 'https:';
const port = url.port || (isHttps ? 443 : 80);
@@ -166,86 +165,84 @@ function plazaPublicReachable() {
});
}
async function ensurePlazaPublicProxy() {
if (await plazaPublicReachable()) {
console.log(`==> Plaza 公开入口已可用: ${plazaPublicBase}/plaza`);
async function ensureLocalTestProxy() {
const h5Ready = await publicReachable(`${H5_PUBLIC_BASE}/`);
if (h5Ready) {
console.log(`==> 本地测试 HTTPS 入口已可用: ${H5_PUBLIC_BASE}`);
return;
}
console.log(`==> 尝试启动 Plaza 80 端口代理 (${plazaPublicBase})...`);
const proxyScript = path.join(root, 'scripts/plaza-local-proxy.mjs');
plazaProxy = spawn('node', [proxyScript], {
console.log(`==> 尝试启动本地 HTTPS 代理 (${H5_PUBLIC_BASE})...`);
const proxyScript = path.join(root, 'scripts/local-test-proxy.mjs');
localProxy = spawn('node', [proxyScript], {
cwd: root,
env: process.env,
stdio: ['ignore', 'pipe', 'pipe'],
});
let proxyFailed = false;
plazaProxy.stdout?.on('data', (chunk) => process.stdout.write(`[plaza-proxy] ${chunk}`));
plazaProxy.stderr?.on('data', (chunk) => {
localProxy.stdout?.on('data', (chunk) => process.stdout.write(`[local-proxy] ${chunk}`));
localProxy.stderr?.on('data', (chunk) => {
const text = String(chunk);
process.stderr.write(`[plaza-proxy] ${text}`);
process.stderr.write(`[local-proxy] ${text}`);
if (/EACCES|EADDRINUSE|需要 root/.test(text)) proxyFailed = true;
});
plazaProxy.on('exit', (code) => {
localProxy.on('exit', (code) => {
if (code && code !== 0) proxyFailed = true;
});
for (let i = 0; i < 20; i += 1) {
if (proxyFailed) break;
if (await plazaPublicReachable()) {
console.log(`==> Plaza 公开入口已可用: ${plazaPublicBase}/plaza`);
if (await publicReachable(`${H5_PUBLIC_BASE}/`)) {
console.log(`==> 本地测试 HTTPS 入口已可用: ${H5_PUBLIC_BASE}`);
return;
}
await new Promise((resolve) => setTimeout(resolve, 250));
}
console.warn('');
console.warn(`⚠ 无法在本进程绑定 ${plazaPublicPort} 端口，${plazaPublicBase} 暂不可用`);
console.warn(' 请先：sudo pnpm setup:plaza-local');
console.warn(' 再另开终端：sudo pnpm dev:plaza-proxy');
console.warn('⚠ 本地 test 域名 HTTPS 入口暂不可用');
console.warn(' 请先：sudo pnpm setup:local-test');
console.warn(' 再另开终端：sudo pnpm dev:local-proxy');
console.warn(' 文档：docs/local-dev.md');
console.warn('');
}
function plazaHostConfigured(host) {
try {
const hosts = fs.readFileSync('/etc/hosts', 'utf8');
return new RegExp(`^\\s*127\\.0\\.0\\.1\\s+${host.replace('.', '\\.')}(\\s|$)`, 'm').test(hosts);
} catch {
return false;
}
}
console.log(`==> 清理端口 ${portalPort} / ${adminPort} / ${vitePort} / ${plazaPort} / ${opsPort}...`);
console.log(`==> 清理端口 ${portalPort} / ${adminPort} / ${vitePort} / ${plazaPort} / ${opsPort} / ${DNS_PORT}...`);
freePort(portalPort);
freePort(adminPort);
freePort(vitePort);
freePort(plazaPort);
freePort(opsPort);
freePort(DNS_PORT);
await new Promise((resolve) => setTimeout(resolve, 500));
ensurePlazaApp();
if (!plazaHostConfigured(plazaHost)) {
if (!allHostsConfigured()) {
console.warn('');
console.warn(`⚠ ${plazaHost} 尚未写入 /etc/hosts，浏览器无法打开 ${plazaPublicBase}`);
console.warn(' 请执行：sudo pnpm setup:plaza-dns');
console.warn('⚠ 本地 test 域名 DNS 未完整配置（Tailscale/Clash 可能劫持解析）');
console.warn(' 请执行：sudo pnpm setup:local-test');
console.warn(' 文档：docs/local-dev.md');
console.warn('');
}
console.log('==> 启动本地 test DNS...');
dnsServer = spawnChild('node', ['scripts/local-test-dns-server.mjs'], 'local-dns');
console.log('==> 启动 portal (server.mjs)...');
server = spawnChild('node', ['server.mjs'], 'portal');
try {
await waitFor(portalUrl, async (url) => (await fetch(`${url}/auth/status`)).ok, 'Portal');
console.log(`==> Portal 就绪: ${portalUrl}`);
console.log(`==> Portal 就绪 (内部 ${portalUrl})`);
console.log('==> 启动 memind_adm (admin-server.mjs)...');
admin = spawnChild('node', ['admin-server.mjs'], 'admin');
await waitFor(adminUrl, async (url) => (await fetch(`${url}/healthz`)).ok, 'Admin');
console.log(`==> memind_adm 就绪: ${adminUrl}`);
console.log(`==> memind_adm 就绪 (内部 ${adminUrl} → ${publicUrl(ADMIN_HOST)})`);
console.log(`==> 启动 Plaza Next.js @ ${plazaPublicBase} (bind ${plazaHost})`);
console.log(`==> 启动 Plaza Next.js @ ${PLAZA_PUBLIC_BASE} (bind ${PLAZA_HOST})`);
plaza = spawnChild(
'npm',
['run', 'dev', '--', '-H', '0.0.0.0', '-p', String(plazaPort)],
@@ -257,27 +254,26 @@ try {
`http://127.0.0.1:${plazaPort}`,
async (url) => {
const res = await fetch(`${url}/plaza`, {
headers: { Host: `${plazaHost}:${plazaPort}` },
headers: { Host: `${PLAZA_HOST}:${plazaPort}` },
});
return res.ok || res.status === 307 || res.status === 308;
},
'Plaza',
80,
);
console.log(`==> Plaza 内部就绪: http://127.0.0.1:${plazaPort}/plaza`);
await ensurePlazaPublicProxy();
console.log(`==> Plaza 就绪: ${PLAZA_PUBLIC_BASE}/plaza`);
console.log(`==> 启动 Ops 后台 @ ${opsUrl}/ops/`);
console.log(`==> 启动 Ops 后台 @ ${publicUrl(OPS_HOST)}/ops/`);
ops = spawnChild('npm', ['run', 'dev'], 'ops', opsDir, opsEnv);
await waitFor(
`http://localhost:${opsPort}`,
`http://127.0.0.1:${opsPort}`,
async (url) => (await fetch(`${url}/ops/`)).ok,
'Ops',
40,
);
console.log(`==> Ops 就绪: http://localhost:${opsPort}/ops/`);
console.log(`==> Ops 就绪: ${publicUrl(OPS_HOST)}/ops/`);
console.log(`==> 启动 Vite @ http://localhost:${vitePort}`);
console.log(`==> 启动 Vite @ ${H5_PUBLIC_BASE}`);
vite = spawnChild('npx', ['vite'], 'vite', root, viteEnv);
await waitFor(
`http://127.0.0.1:${vitePort}`,
@@ -290,17 +286,19 @@ try {
},
'Vite',
);
console.log(`==> Vite 就绪: http://localhost:${vitePort}`);
console.log(`==> Vite 就绪: ${H5_PUBLIC_BASE}`);
await ensureLocalTestProxy();
console.log('');
console.log('本地服务：');
console.log(` MindSpace UI http://localhost:${vitePort}/?preview=mindspace`);
console.log(` Plaza 广场 ${plazaPublicBase}/plaza`);
console.log(` Plaza 内部 http://127.0.0.1:${plazaPort}/plaza`);
console.log(` (setup) sudo pnpm setup:plaza-local && sudo pnpm dev:plaza-proxy`);
console.log(` Ops 审核后台 http://localhost:${opsPort}/ops/`);
console.log(` API / Portal ${portalUrl}`);
console.log(` memind_adm ${adminUrl} (gadm.tkmind.cn)`);
console.log('本地服务（请用 test 域名访问，见 docs/local-dev.md）：');
console.log(` MindSpace UI ${H5_PUBLIC_BASE}/?preview=mindspace`);
console.log(` Plaza 广场 ${PLAZA_PUBLIC_BASE}/plaza`);
console.log(` Ops 审核后台 ${publicUrl(OPS_HOST)}/ops/`);
console.log(` memind_adm ${publicUrl(ADMIN_HOST)}`);
console.log('');
console.log('HTTPS 代理：sudo pnpm dev:local-proxy');
console.log('诊断：pnpm check:local-test');
console.log('');
console.log('首次使用 Ops：先登录 MindSpace，再执行 node scripts/grant-ops-role.mjs admin ops_admin');
} catch (err) {