Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
/**
* Pinned HTTPS request policy shared by artifact downloads.
*
* A fixed URL is the only accepted entry point. Redirects are refused unless
* the caller opts into an explicit host allow-list (GitHub release assets);
* even then every hop must stay on HTTPS with no credentials or odd ports.
*/
const REDIRECT_STATUSES = new Set([301, 302, 303, 307, 308])
export function assertFixedUrl(url, expectedUrl) {
if (typeof expectedUrl !== 'string' || !expectedUrl.startsWith('https://')) {
throw new Error(`Fixed artifact URL must be https: ${expectedUrl}`)
}
if (typeof url !== 'string' || !url.startsWith('https://')) {
throw new Error(`Refusing non-https artifact URL: ${url}`)
}
if (url !== expectedUrl) {
throw new Error(`Refusing download from a non-fixed artifact URL: ${url}`)
}
}
async function assertAllowedRedirect(nextUrl, allowedHosts, previousUrl) {
let parsed
try {
parsed = new URL(nextUrl, previousUrl)
} catch {
throw new Error(`Refusing invalid redirect target: ${nextUrl}`)
}
if (parsed.protocol !== 'https:') {
throw new Error(`Refusing non-https redirect target: ${parsed.href}`)
}
if (parsed.username || parsed.password) {
throw new Error(`Refusing redirect target with credentials: ${parsed.href}`)
}
if (parsed.port && parsed.port !== '443') {
throw new Error(`Refusing redirect target with a non-443 port: ${parsed.href}`)
}
if (!allowedHosts.includes(parsed.hostname)) {
throw new Error(`Refusing redirect to a non-allowlisted host: ${parsed.hostname}`)
}
return parsed.href
}
export async function fetchPinnedResponse({
url,
expectedUrl,
allowedRedirectHosts,
fetchImpl,
signal
}) {
assertFixedUrl(url, expectedUrl)
let current = url
for (let hop = 0; hop <= 5; hop += 1) {
const res = await fetchImpl(current, {
signal,
redirect: allowedRedirectHosts ? 'manual' : 'error'
})
if (!res || typeof res !== 'object') throw new Error('Artifact fetch returned no response')
if (res.redirected) {
throw new Error(`Refusing redirected artifact response: ${res.url ?? 'unknown'}`)
}
if (REDIRECT_STATUSES.has(res.status) && allowedRedirectHosts) {
await res.body?.cancel?.().catch?.(() => {})
const location = res.headers?.get?.('location')
if (typeof location !== 'string' || location.length === 0) {
throw new Error(`Redirect response ${res.status} has no location`)
}
current = await assertAllowedRedirect(location, allowedRedirectHosts, current)
continue
}
if (!res.ok) {
throw new Error(`Failed to download artifact: HTTP ${res.status} ${res.statusText ?? ''}`.trim())
}
if (current !== expectedUrl && !allowedRedirectHosts) {
throw new Error(`Refusing download from a non-fixed artifact URL: ${current}`)
}
if (res.url !== undefined && res.url !== current) {
throw new Error(`Refusing redirected artifact response: ${res.url}`)
}
return res
}
throw new Error('Refusing artifact download with too many redirects')
}