/** * System info, health, events, df, browse, registry, metrics. */ import fs from 'fs' import path from 'path' import { docker } from '../services/docker.js' import * as validation from '../utils/validation.js' import { PROTOCOL, PROTOCOL_VERSION } from '../../shared/protocol.js' import { getMetricsSnapshot } from '../services/metrics.js' import { peers } from '../core/peer-registry.js' import { isSwarmEnabled } from './swarm.js' import { isPluginsEnabled } from './plugins.js' import logger from '../utils/logger.js' /** @type {Map} */ const registryAuth = new Map() export function registerSystemHandlers(session) { session.respond('ping', async () => { let dockerOk = false let apiVersion = null let osType = null let error = null try { const version = await docker.version() dockerOk = true apiVersion = version.ApiVersion || version.apiVersion || null osType = version.Os || version.os || null } catch (err) { error = err.message } return { success: true, pong: Date.now(), protocol: PROTOCOL, protocolVersion: PROTOCOL_VERSION, role: session.role, docker: { ok: dockerOk, apiVersion, os: osType, error, }, features: { swarm: isSwarmEnabled(), plugins: isPluginsEnabled(), }, } }) session.respond('getSystemInfo', async () => { const [info, version] = await Promise.all([docker.info(), docker.version()]) return { type: 'systemInfo', data: { info, version } } }) session.respond('getSystemDf', async () => { const data = await docker.df() return { type: 'systemDf', data, success: true } }) session.respond('getMetrics', async () => { return getMetricsSnapshot({ peerCount: peers.size }) }) session.respond('getDockerEvents', async (args) => { // Snapshot: recent events via stream with timeout (best-effort) const since = args?.since || Math.floor(Date.now() / 1000) - 300 const until = args?.until || Math.floor(Date.now() / 1000) const events = [] try { await new Promise((resolve, reject) => { const timer = setTimeout(() => { try { stream?.destroy?.() } catch { // ignore } resolve() }, args?.timeoutMs || 1500) let stream docker.getEvents({ since, until }, (err, s) => { if (err) { clearTimeout(timer) reject(err) return } stream = s stream.on('data', (chunk) => { try { const lines = chunk.toString().split('\n').filter(Boolean) for (const line of lines) { events.push(JSON.parse(line)) } } catch { // ignore partial } }) stream.on('end', () => { clearTimeout(timer) resolve() }) stream.on('error', (e) => { clearTimeout(timer) reject(e) }) }) }) } catch (err) { logger.debug('getDockerEvents snapshot failed', { error: err.message }) } return { type: 'dockerEvents', data: events, success: true, note: 'Live events are also pushed as push:dockerEvent when streaming.', } }) session.respond('registryLogin', async (args) => { const username = validation.sanitizeString(args.username, 128) const password = args.password const serveraddress = validation.sanitizeString(args.serveraddress || 'https://index.docker.io/v1/', 512) if (!username || !password) throw new Error('username and password required') const authconfig = { username, password, serveraddress } // dockerode checkAuth try { await new Promise((resolve, reject) => { docker.checkAuth(authconfig, (err, response) => { if (err) reject(err) else resolve(response) }) }) } catch (err) { // Some engines return status in different shapes; still store for pull attempts logger.warn('checkAuth soft-fail, storing credentials', { error: err.message }) } registryAuth.set(session.id, { username, serveraddress, password }) session.state.set('registryAuth', { username, serveraddress, password }) return { success: true, message: `Authenticated as ${username}`, data: { username, serveraddress }, } }) session.respond('getAuthStatus', async () => { const auth = session.state.get('registryAuth') || registryAuth.get(session.id) return { success: true, authenticated: Boolean(auth), username: auth?.username || null, serveraddress: auth?.serveraddress || null, } }) session.respond('browseDirectory', async (args) => { const requestedPath = args?.path || '/' if (!validation.isValidDirectoryPath(requestedPath)) { throw new Error('Invalid directory path') } // Default-deny host FS unless PEARDOCK_BROWSE_ROOTS is set (or PEARDOCK_BROWSE_OPEN=1 for legacy open browse) const roots = (process.env.PEARDOCK_BROWSE_ROOTS || '') .split(',') .map((s) => s.trim()) .filter(Boolean) const openBrowse = process.env.PEARDOCK_BROWSE_OPEN === '1' || process.env.PEARDOCK_BROWSE_OPEN === 'true' const safePath = validation.sanitizeDirectoryPath(requestedPath) if (roots.length === 0 && !openBrowse) { throw new Error( 'Host filesystem browse is disabled (default-deny). Set PEARDOCK_BROWSE_ROOTS=/allowed/path or PEARDOCK_BROWSE_OPEN=1' ) } if (roots.length > 0) { const ok = roots.some((root) => safePath === root || safePath.startsWith(root.endsWith('/') ? root : root + '/')) if (!ok) throw new Error('Path not in allowlisted browse roots') } try { const stats = fs.statSync(safePath) if (!stats.isDirectory()) { throw new Error('Not a directory: The specified path is not a directory') } } catch (statError) { if (statError.code === 'ENOENT') { throw new Error('Directory not found: The specified path does not exist') } if (statError.code === 'EACCES') { throw new Error('Permission denied: You do not have permission to access this directory') } throw statError } const contents = [] try { const items = fs.readdirSync(safePath, { withFileTypes: true }) for (const item of items) { try { const itemPath = path.join(safePath, item.name) const stats = fs.statSync(itemPath) contents.push({ name: item.name, type: item.isDirectory() ? 'directory' : 'file', size: stats.size, modified: stats.mtime.toISOString(), permissions: stats.mode.toString(8).slice(-3), }) } catch { // skip } } return { success: true, contents, path: safePath } } catch (readError) { if (readError.code === 'EACCES') { throw new Error('Permission denied: You do not have permission to access this directory') } if (readError.code === 'ENOENT') { throw new Error('Directory not found: The specified path does not exist') } if (readError.code === 'ENOTDIR') { throw new Error('Not a directory: The specified path is not a directory') } throw new Error(`Failed to read directory: ${readError.message}`) } }) } /** * Auth config for docker pull/push for this session, if any. * @param {import('../rpc/session.js').PeerSession} session */ export function getSessionAuthconfig(session) { return session.state.get('registryAuth') || registryAuth.get(session.id) || null }