diff --git a/docs/guide.md b/docs/guide.md index 6d164c694dea..60098ca7e679 100644 --- a/docs/guide.md +++ b/docs/guide.md @@ -20,6 +20,7 @@ - [Proxying to a Vue app](#proxying-to-a-vue-app) - [Proxying to an Angular app](#proxying-to-an-angular-app) - [Proxying to a Svelte app](#proxying-to-a-svelte-app) + - [Prefixing `/absproxy/` with a path](#prefixing-absproxyport-with-a-path) @@ -432,3 +433,12 @@ const config = { 3. Access app at `/absproxy/5173/` e.g. `http://localhost:8080/absproxy/5173/ For additional context, see [this Github Issue](https://github.com/sveltejs/kit/issues/2958) + +### Prefixing `/absproxy/` with a path + +This is a case where you need to serve an application via `absproxy` as explained above while serving `codeserver` itself from a path other than the root in your domain. + +For example: `http://my-code-server.com/user/123/workspace/my-app`. To achieve this result: + +1. Start code server with the switch `--abs-proxy-base-path=/user/123/workspace` +2. Follow one of the instructions above for your framework. diff --git a/src/node/cli.ts b/src/node/cli.ts index 69890279e396..6320c2025239 100644 --- a/src/node/cli.ts +++ b/src/node/cli.ts @@ -53,6 +53,7 @@ export interface UserProvidedCodeArgs { "disable-getting-started-override"?: boolean "disable-proxy"?: boolean "session-socket"?: string + "abs-proxy-base-path"?: string } /** @@ -279,6 +280,10 @@ export const options: Options> = { short: "w", description: "Text to show on login page", }, + "abs-proxy-base-path": { + type: "string", + description: "The base path to prefix to all absproxy requests", + }, } export const optionDescriptions = (opts: Partial>> = options): string[] => { diff --git a/src/node/routes/index.ts b/src/node/routes/index.ts index 1be3988ca3ad..e61cbd65795c 100644 --- a/src/node/routes/index.ts +++ b/src/node/routes/index.ts @@ -121,11 +121,13 @@ export const register = async (app: App, args: DefaultedArgs): Promise { await pathProxy.proxy(req, res, { passthroughPath: true, + proxyBasePath: args["abs-proxy-base-path"], }) }) app.wsRouter.get("/absproxy/:port/:path(.*)?", async (req) => { await pathProxy.wsProxy(req as pluginapi.WebsocketRequest, { passthroughPath: true, + proxyBasePath: args["abs-proxy-base-path"], }) }) diff --git a/src/node/routes/pathProxy.ts b/src/node/routes/pathProxy.ts index 7f69bcf9eb17..ccfb0cc824a0 100644 --- a/src/node/routes/pathProxy.ts +++ b/src/node/routes/pathProxy.ts @@ -5,10 +5,15 @@ import { HttpCode, HttpError } from "../../common/http" import { ensureProxyEnabled, authenticated, ensureAuthenticated, ensureOrigin, redirect, self } from "../http" import { proxy as _proxy } from "../proxy" -const getProxyTarget = (req: Request): string => { +const getProxyTarget = ( + req: Request, + opts?: { + proxyBasePath?: string + }, +): string => { // If there is a base path, strip it out. const base = (req as any).base || "" - return `http://0.0.0.0:${req.params.port}/${req.originalUrl.slice(base.length)}` + return `http://0.0.0.0:${req.params.port}${opts?.proxyBasePath || ""}/${req.originalUrl.slice(base.length)}` } export async function proxy( @@ -16,6 +21,7 @@ export async function proxy( res: Response, opts?: { passthroughPath?: boolean + proxyBasePath?: string }, ): Promise { ensureProxyEnabled(req) @@ -38,7 +44,7 @@ export async function proxy( _proxy.web(req, res, { ignorePath: true, - target: getProxyTarget(req), + target: getProxyTarget(req, opts), }) } @@ -46,6 +52,7 @@ export async function wsProxy( req: pluginapi.WebsocketRequest, opts?: { passthroughPath?: boolean + proxyBasePath?: string }, ): Promise { ensureProxyEnabled(req) @@ -59,6 +66,6 @@ export async function wsProxy( _proxy.ws(req, req.ws, req.head, { ignorePath: true, - target: getProxyTarget(req), + target: getProxyTarget(req, opts), }) } diff --git a/test/unit/node/cli.test.ts b/test/unit/node/cli.test.ts index 02b60b839efb..e596549da100 100644 --- a/test/unit/node/cli.test.ts +++ b/test/unit/node/cli.test.ts @@ -106,6 +106,8 @@ describe("parser", () => { "--disable-proxy", + ["--abs-proxy-base-path", "/codeserver/app1"], + ["--session-socket", "/tmp/override-code-server-ipc-socket"], ["--host", "0.0.0.0"], @@ -143,6 +145,7 @@ describe("parser", () => { version: true, "bind-addr": "192.169.0.1:8080", "session-socket": "/tmp/override-code-server-ipc-socket", + "abs-proxy-base-path": "/codeserver/app1", }) }) diff --git a/test/unit/node/proxy.test.ts b/test/unit/node/proxy.test.ts index 9e8017e37700..186cd475b3e2 100644 --- a/test/unit/node/proxy.test.ts +++ b/test/unit/node/proxy.test.ts @@ -256,6 +256,18 @@ describe("proxy", () => { expect(spy).toHaveBeenCalledWith([test.expected, test.query]) } }) + + it("should allow specifying an absproxy path", async () => { + const prefixedPath = `/codeserver/app1${absProxyPath}` + e.get(prefixedPath, (req, res) => { + res.send("app being served behind a prefixed path") + }) + codeServer = await integration.setup(["--auth=none", "--abs-proxy-base-path=/codeserver/app1"], "") + const resp = await codeServer.fetch(absProxyPath) + expect(resp.status).toBe(200) + const text = await resp.text() + expect(text).toBe("app being served behind a prefixed path") + }) }) // NOTE@jsjoeio