The best way to control Claude Code, Codex and more from any computer or phone
feat(server): setting and managed policy to turn off the preview tunnel (#39415)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Julius Marminge committed
Nov 19, 2026 at 15:47 UTC
dcf158c5915baaf961ddc1bce06cafd4d2eeeb00
46 files changed
+472
-30
apps/mobile/src/features/browser/BrowserTabMenu.tsx
+3
-1
@@ -16,6 +16,7 @@ import { msg, useGT, useMessages } from "gt-react-native";
16
import { ControlPill } from "../../components/ui/ControlPill";
17
import { Menu } from "../../components/ui/Menu";
18
import { m } from "../../i18n/messages";
19
+import { useEnvironmentPreviewTunnelOff } from "../../state/entities";
20
import { previewEnvironment } from "../../state/preview";
21
import { useAtomCommand } from "../../state/use-atom-command";
22
import { browserTabUrl, loopbackUrlForDevice } from "./browserTabs";
@@ -65,6 +66,7 @@ export function BrowserTabMenu({
66
readonly onReleaseControl?: () => void;
67
}) {
68
const openLocalPreview = useOpenLocalPreview();
69
+ const tunnelOff = useEnvironmentPreviewTunnelOff(environmentId);
70
const adjust = useAtomCommand(previewEnvironment.adjust, "browser tab change");
71
const resize = useAtomCommand(previewEnvironment.resize, "browser viewport change");
72
const close = useAtomCommand(previewEnvironment.close, "browser tab close");
@@ -92,7 +94,7 @@ export function BrowserTabMenu({
94
image: "xmark",
95
attributes: { destructive: true, disabled: !canClose },
96
};
95
- const deviceUrl = loopbackUrlForDevice(browserTabUrl(tab));
97
+ const deviceUrl = tunnelOff ? null : loopbackUrlForDevice(browserTabUrl(tab));
98
// The device preview has its own webview and tunnel, so it doesn't wait for the stream.
99
const openOnDevice: MenuAction[] = deviceUrl
100
? [{ id: "open-on-device", title: gt("Open on this device"), image: "iphone" }]
apps/mobile/src/features/browser/LocalPreviewRouteScreen.tsx
+21
-2
@@ -10,6 +10,7 @@ import { AppText } from "../../components/ui/AppText";
10
import * as Dialog from "../../components/ui/Dialog";
11
import { EmptyState } from "../../components/ui/EmptyState";
12
import { m } from "../../i18n/messages";
13
+import { useEnvironmentPreviewTunnelOff } from "../../state/entities";
14
import { useEnvironments } from "../../state/environments";
15
import { useAppearancePreferences } from "../settings/appearance/AppearancePreferencesProvider";
16
import { BrowserChrome } from "./BrowserBar";
@@ -49,6 +50,7 @@ export function LocalPreviewScreen(props: {
50
useEnvironments().presentationById.get(environmentId)?.entry.target.label ??
51
gt("the environment", { $context: "stands in for an environment name in a sentence" });
52
const { themeVariables } = useAppearancePreferences();
53
+ const tunnelOff = useEnvironmentPreviewTunnelOff(environmentId);
54
const webView = useRef<TunnelWebViewRef>(null);
55
const [requested, setRequested] = useState(initialUrl);
56
const [page, setPage] = useState<TunnelNavigation | null>(null);
@@ -77,7 +79,7 @@ export function LocalPreviewScreen(props: {
79
};
80
const back = () => void webView.current?.goBack();
81
const canGoBack = page?.canGoBack ?? false;
80
- const pageColor = failed || unsupported !== null ? null : page?.pageColor || null;
82
+ const pageColor = failed || tunnelOff || unsupported !== null ? null : page?.pageColor || null;
83
84
return (
85
// Full screen spans the Duo's rail, so it insets its own sides; the pane is inset already.
@@ -127,7 +129,24 @@ export function LocalPreviewScreen(props: {
129
setFailed(true);
130
}}
131
/>
130
- {unsupported !== null ? (
132
+ {tunnelOff ? (
133
+ <View
134
+ className="absolute inset-0 items-center justify-center"
135
+ style={{ backgroundColor: themeVariables["--color-sheet-solid"] }}
136
+ >
137
+ <View className="w-full max-w-md">
138
+ <EmptyState
139
+ variant="plain"
140
+ title={gt("{environment} doesn't share its localhost", {
141
+ environment: environmentLabel,
142
+ })}
143
+ detail={gt(
144
+ "The preview tunnel is off there, so its local servers only open in the streamed browser.",
145
+ )}
146
+ />
147
+ </View>
148
+ </View>
149
+ ) : unsupported !== null ? (
150
<View
151
className="absolute inset-0 items-center justify-center"
152
style={{ backgroundColor: themeVariables["--color-sheet-solid"] }}
apps/mobile/src/features/threads/ThreadFeed.tsx
+8
-3
@@ -289,6 +289,7 @@ import {
289
} from "@t3tools/client-runtime/workspace-basename-lookup";
290
import {
291
resolveThreadLink,
292
+ useEnvironmentPreviewTunnelOff,
293
useLiveThreadLinkLabels,
294
useQuietThreadShell,
295
useThreadChipIcons,
@@ -3139,6 +3140,10 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3140
const navigation = useNavigation();
3141
const openLinkedThread = useOpenLinkedThread();
3142
const openLocalPreview = useOpenLocalPreview();
3143
+ const previewTunnelOff = useEnvironmentPreviewTunnelOff(props.environmentId);
3144
+ // Without the tunnel, loopback links fall through to the system browser like any other link.
3145
+ const deviceLoopbackUrl = (href: string) =>
3146
+ previewTunnelOff ? null : loopbackUrlForDevice(href);
3147
// Recycling a row disposes its native audio player, so a started clip's row stays rendered.
3148
const [retainedMediaRowId, setRetainedMediaRowId] = useState<string | null>(null);
3149
const focused = useIsFocused();
@@ -3421,7 +3426,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3426
return;
3427
}
3428
// Safari would open the phone's own localhost, so these open on the device by default.
3424
- const deviceUrl = loopbackUrlForDevice(href);
3429
+ const deviceUrl = deviceLoopbackUrl(href);
3430
if (deviceUrl) {
3431
openLocalPreview(
3432
{ environmentId: String(props.environmentId), threadId: String(props.threadId) },
@@ -3559,7 +3564,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3564
};
3565
}
3566
// The environment's localhost, which this device can only reach through the tunnel.
3562
- if (loopbackUrlForDevice(href)) {
3567
+ if (deviceLoopbackUrl(href)) {
3568
return {
3569
title: href,
3570
actions: [
@@ -3585,7 +3590,7 @@ export const ThreadFeed = memo(function ThreadFeed(props: ThreadFeedProps) {
3590
else if (actionId === "copy-thread-link") copyTextWithHaptic(hostedThreadLink(thread));
3591
return;
3592
}
3588
- const deviceUrl = loopbackUrlForDevice(href);
3593
+ const deviceUrl = deviceLoopbackUrl(href);
3594
if (deviceUrl) {
3595
if (actionId === "open-on-device") {
3596
markdownLinkRequest.current?.abort();
apps/mobile/src/i18n/translations/de.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "Die Richtlinie von {organization} erlaubt T3 Connect nicht.",
24
"986b0873f913a840": "Die Richtlinie von {organization} erlaubt keine Webhook-Aufgaben.",
25
"eebc538e25b09fe2": "Die Richtlinie von {organization} erlaubt keinen Import von Browser-Cookies.",
26
+ "7642a133db05f164": "Die Richtlinie von {organization} erlaubt nicht, die lokalen Server dieses Rechners auf anderen Geräten zu öffnen.",
27
"39f6771b49f9b3b6": "Standard verwenden",
28
"45bb0e90e1c42046": "Wenn du zurückkommst",
29
"d8fa0a55446bbb0d": "Bevor der Cache abläuft (Beta)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Cache leeren",
1782
"4d7f5af0445371fd": "Optionen für Browser-Tab",
1783
"27025b00be488485": "die Umgebung",
1784
+ "4391875125b7882c": "{environment} teilt seinen localhost nicht",
1785
+ "ec7a78dd403ccf6a": "Der Vorschau-Tunnel ist dort ausgeschaltet, daher öffnen sich seine lokalen Server nur im gestreamten Browser.",
1786
"e1ffd0532d64e52c": "Dieses Gerät kann keine localhost-Seiten öffnen",
1787
"f72cc72b321f93a5": "{reason} Für diesen Tab kannst du weiterhin den gestreamten Browser verwenden.",
1788
"6bf09d4b7e4ba53b": "T3 Code auf {environment} aktualisieren",
apps/mobile/src/i18n/translations/en.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization}'s policy does not allow T3 Connect.",
24
"986b0873f913a840": "{organization}'s policy does not allow webhook tasks.",
25
"eebc538e25b09fe2": "{organization}'s policy does not allow importing browser cookies.",
26
+ "7642a133db05f164": "{organization}'s policy does not allow opening this machine's local servers on other devices.",
27
"39f6771b49f9b3b6": "Use default",
28
"45bb0e90e1c42046": "When you return",
29
"d8fa0a55446bbb0d": "Before the cache expires (beta)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Clear cache",
1782
"4d7f5af0445371fd": "Browser tab options",
1783
"27025b00be488485": "the environment",
1784
+ "4391875125b7882c": "{environment} doesn't share its localhost",
1785
+ "ec7a78dd403ccf6a": "The preview tunnel is off there, so its local servers only open in the streamed browser.",
1786
"e1ffd0532d64e52c": "This device can't open localhost pages",
1787
"f72cc72b321f93a5": "{reason} You can still use the streamed browser for this tab.",
1788
"6bf09d4b7e4ba53b": "Update T3 Code on {environment}",
apps/mobile/src/i18n/translations/es.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "La política de {organization} no permite T3 Connect.",
24
"986b0873f913a840": "La política de {organization} no permite tareas de webhook.",
25
"eebc538e25b09fe2": "La política de {organization} no permite importar cookies del navegador.",
26
+ "7642a133db05f164": "La política de {organization} no permite abrir los servidores locales de esta máquina en otros dispositivos.",
27
"39f6771b49f9b3b6": "Usar valor predeterminado",
28
"45bb0e90e1c42046": "Cuando vuelvas",
29
"d8fa0a55446bbb0d": "Antes de que caduque la caché (beta)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Borrar caché",
1782
"4d7f5af0445371fd": "Opciones de la pestaña del navegador",
1783
"27025b00be488485": "el entorno",
1784
+ "4391875125b7882c": "{environment} no comparte su localhost",
1785
+ "ec7a78dd403ccf6a": "El túnel de vista previa está desactivado allí, así que sus servidores locales solo se abren en el navegador transmitido.",
1786
"e1ffd0532d64e52c": "Este dispositivo no puede abrir páginas de localhost",
1787
"f72cc72b321f93a5": "{reason} Aún puedes usar el navegador transmitido para esta pestaña.",
1788
"6bf09d4b7e4ba53b": "Actualiza T3 Code en {environment}",
apps/mobile/src/i18n/translations/fr.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "La politique de {organization} n’autorise pas T3 Connect.",
24
"986b0873f913a840": "La politique de {organization} n’autorise pas les tâches webhook.",
25
"eebc538e25b09fe2": "La politique de {organization} n’autorise pas l’import des cookies du navigateur.",
26
+ "7642a133db05f164": "La stratégie de {organization} n’autorise pas l’ouverture des serveurs locaux de cette machine sur d’autres appareils.",
27
"39f6771b49f9b3b6": "Utiliser la valeur par défaut",
28
"45bb0e90e1c42046": "À votre retour",
29
"d8fa0a55446bbb0d": "Avant l’expiration du cache (bêta)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Vider le cache",
1782
"4d7f5af0445371fd": "Options de l’onglet du navigateur",
1783
"27025b00be488485": "l’environnement",
1784
+ "4391875125b7882c": "{environment} ne partage pas son localhost",
1785
+ "ec7a78dd403ccf6a": "Le tunnel d’aperçu y est désactivé, ses serveurs locaux ne s’ouvrent donc que dans le navigateur diffusé.",
1786
"e1ffd0532d64e52c": "Cet appareil ne peut pas ouvrir les pages localhost",
1787
"f72cc72b321f93a5": "{reason} Tu peux toujours utiliser le navigateur diffusé pour cet onglet.",
1788
"6bf09d4b7e4ba53b": "Mettez à jour T3 Code sur {environment}",
apps/mobile/src/i18n/translations/ja.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization} のポリシーでは、T3 Connect は許可されていません。",
24
"986b0873f913a840": "{organization} のポリシーでは、Webhook タスクは許可されていません。",
25
"eebc538e25b09fe2": "{organization} のポリシーでは、ブラウザーの Cookie のインポートは許可されていません。",
26
+ "7642a133db05f164": "{organization} のポリシーでは、このマシンのローカルサーバーを他のデバイスで開くことは許可されていません。",
27
"39f6771b49f9b3b6": "デフォルトを使用",
28
"45bb0e90e1c42046": "戻ってきたとき",
29
"d8fa0a55446bbb0d": "キャッシュの期限切れ前 (ベータ)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "キャッシュを消去",
1782
"4d7f5af0445371fd": "ブラウザータブのオプション",
1783
"27025b00be488485": "環境",
1784
+ "4391875125b7882c": "{environment} は localhost を共有していません",
1785
+ "ec7a78dd403ccf6a": "そちらではプレビュートンネルがオフのため、ローカルサーバーはストリーミングブラウザでのみ開けます。",
1786
"e1ffd0532d64e52c": "このデバイスでは localhost のページを開けません",
1787
"f72cc72b321f93a5": "{reason} このタブではストリーミングブラウザを引き続き使えます。",
1788
"6bf09d4b7e4ba53b": "{environment} の T3 Code を更新してください",
apps/mobile/src/i18n/translations/ko.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization}의 정책상 T3 Connect를 사용할 수 없습니다.",
24
"986b0873f913a840": "{organization}의 정책상 웹후크 작업을 사용할 수 없습니다.",
25
"eebc538e25b09fe2": "{organization}의 정책상 브라우저 쿠키를 가져올 수 없습니다.",
26
+ "7642a133db05f164": "{organization}의 정책은 이 컴퓨터의 로컬 서버를 다른 기기에서 여는 것을 허용하지 않습니다.",
27
"39f6771b49f9b3b6": "기본값 사용",
28
"45bb0e90e1c42046": "돌아왔을 때",
29
"d8fa0a55446bbb0d": "캐시가 만료되기 전(베타)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "캐시 지우기",
1782
"4d7f5af0445371fd": "브라우저 탭 옵션",
1783
"27025b00be488485": "환경",
1784
+ "4391875125b7882c": "{environment}에서 localhost를 공유하지 않습니다",
1785
+ "ec7a78dd403ccf6a": "그곳에서 미리보기 터널이 꺼져 있어 로컬 서버는 스트리밍 브라우저에서만 열립니다.",
1786
"e1ffd0532d64e52c": "이 기기에서는 localhost 페이지를 열 수 없습니다",
1787
"f72cc72b321f93a5": "{reason} 이 탭에서는 스트리밍 브라우저를 계속 사용할 수 있습니다.",
1788
"6bf09d4b7e4ba53b": "{environment}의 T3 Code를 업데이트하세요",
apps/mobile/src/i18n/translations/pt-BR.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "A política de {organization} não permite o T3 Connect.",
24
"986b0873f913a840": "A política de {organization} não permite tarefas de webhook.",
25
"eebc538e25b09fe2": "A política de {organization} não permite importar cookies do navegador.",
26
+ "7642a133db05f164": "A política de {organization} não permite abrir os servidores locais desta máquina em outros dispositivos.",
27
"39f6771b49f9b3b6": "Usar padrão",
28
"45bb0e90e1c42046": "Quando você voltar",
29
"d8fa0a55446bbb0d": "Antes de o cache expirar (beta)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Limpar cache",
1782
"4d7f5af0445371fd": "Opções da aba do navegador",
1783
"27025b00be488485": "o ambiente",
1784
+ "4391875125b7882c": "{environment} não compartilha seu localhost",
1785
+ "ec7a78dd403ccf6a": "O túnel de pré-visualização está desativado lá, então seus servidores locais só abrem no navegador transmitido.",
1786
"e1ffd0532d64e52c": "Este dispositivo não consegue abrir páginas de localhost",
1787
"f72cc72b321f93a5": "{reason} Você ainda pode usar o navegador transmitido para esta aba.",
1788
"6bf09d4b7e4ba53b": "Atualize o T3 Code em {environment}",
apps/mobile/src/i18n/translations/ru.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "Политика {organization} запрещает T3 Connect.",
24
"986b0873f913a840": "Политика {organization} запрещает задачи по вебхуку.",
25
"eebc538e25b09fe2": "Политика {organization} запрещает импорт cookie браузера.",
26
+ "7642a133db05f164": "Политика {organization} не разрешает открывать локальные серверы этого компьютера на других устройствах.",
27
"39f6771b49f9b3b6": "По умолчанию",
28
"45bb0e90e1c42046": "Когда вы вернётесь",
29
"d8fa0a55446bbb0d": "До истечения кеша (бета)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Очистить кеш",
1782
"4d7f5af0445371fd": "Параметры вкладки браузера",
1783
"27025b00be488485": "окружение",
1784
+ "4391875125b7882c": "{environment} не открывает доступ к своему localhost",
1785
+ "ec7a78dd403ccf6a": "Там выключен туннель предпросмотра, поэтому его локальные серверы открываются только в транслируемом браузере.",
1786
"e1ffd0532d64e52c": "Это устройство не может открывать страницы localhost",
1787
"f72cc72b321f93a5": "{reason} Для этой вкладки можно по-прежнему использовать транслируемый браузер.",
1788
"6bf09d4b7e4ba53b": "Обновите T3 Code на {environment}",
apps/mobile/src/i18n/translations/sv.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "Policyn för {organization} tillåter inte T3 Connect.",
24
"986b0873f913a840": "Policyn för {organization} tillåter inte webhook-uppgifter.",
25
"eebc538e25b09fe2": "Policyn för {organization} tillåter inte import av cookies från webbläsare.",
26
+ "7642a133db05f164": "{organization}s policy tillåter inte att den här datorns lokala servrar öppnas på andra enheter.",
27
"39f6771b49f9b3b6": "Använd standard",
28
"45bb0e90e1c42046": "När du kommer tillbaka",
29
"d8fa0a55446bbb0d": "Innan cachen går ut (beta)",
@@ -1780,6 +1781,8 @@
1781
"9bce41be8fc55a47": "Rensa cache",
1782
"4d7f5af0445371fd": "Alternativ för webbläsarflik",
1783
"27025b00be488485": "miljön",
1784
+ "4391875125b7882c": "{environment} delar inte sin localhost",
1785
+ "ec7a78dd403ccf6a": "Förhandsgranskningstunneln är avstängd där, så dess lokala servrar öppnas bara i den strömmade webbläsaren.",
1786
"e1ffd0532d64e52c": "Den här enheten kan inte öppna localhost-sidor",
1787
"f72cc72b321f93a5": "{reason} Du kan fortfarande använda den strömmade webbläsaren för den här fliken.",
1788
"6bf09d4b7e4ba53b": "Uppdatera T3 Code på {environment}",
apps/mobile/src/i18n/translations/zh.json
+3
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization} 的策略不允许使用 T3 Connect。",
24
"986b0873f913a840": "{organization} 的策略不允许使用 webhook 任务。",
25
"eebc538e25b09fe2": "{organization} 的策略不允许导入浏览器 Cookie。",
26
+ "7642a133db05f164": "{organization} 的策略不允许在其他设备上打开此机器的本地服务器。",
27
"39f6771b49f9b3b6": "使用默认值",
28
"45bb0e90e1c42046": "在你回来后",
29
"d8fa0a55446bbb0d": "缓存过期前(测试版)",
@@ -1781,6 +1782,8 @@
1782
"9bce41be8fc55a47": "清除缓存",
1783
"4d7f5af0445371fd": "浏览器标签页选项",
1784
"27025b00be488485": "该环境",
1785
+ "4391875125b7882c": "{environment} 未共享其 localhost",
1786
+ "ec7a78dd403ccf6a": "那里的预览隧道已关闭,因此其本地服务器只能在串流浏览器中打开。",
1787
"e1ffd0532d64e52c": "此设备无法打开 localhost 页面",
1788
"f72cc72b321f93a5": "{reason} 你仍可以为此标签页使用流式浏览器。",
1789
"6bf09d4b7e4ba53b": "请更新 {environment} 上的 T3 Code",
apps/mobile/src/lib/filePreview.test.ts
+1
@@ -184,6 +184,7 @@ vi.mock("../state/threads", () => ({ environmentThreadShells: {}, threadEnvironm
184
vi.mock("../state/entities", () => ({
185
useLiveThreadLinkLabels: (text: string) => text,
186
useThreadChipIcons: () => new Map(),
187
+ useEnvironmentPreviewTunnelOff: () => false,
188
}));
189
vi.mock("../state/use-thread-selection", () => ({
190
useThreadSelection: () => ({ selectedThread: null }),
apps/mobile/src/state/entities.ts
+7
@@ -8,6 +8,7 @@ import type {
8
EnvironmentThreadShell,
9
} from "@t3tools/client-runtime/state/shell";
10
import {
11
+ allowsPreviewTunnel,
12
EnvironmentId,
13
ThreadId,
14
type ComposerContextRecord,
@@ -304,6 +305,12 @@ export function useEnvironmentServerConfig(
305
);
306
}
307
308
+/** Whether the environment turned its preview tunnel off; false until its config loads. */
309
+export function useEnvironmentPreviewTunnelOff(environmentId: EnvironmentId | null): boolean {
310
+ const config = useEnvironmentServerConfig(environmentId);
311
+ return config !== null && !allowsPreviewTunnel(config);
312
+}
313
+
314
export function useServerConfigs(): ReadonlyMap<EnvironmentId, ServerConfig> {
315
return useAtomValue(environmentServerConfigsAtom);
316
}
apps/server/src/environment/ServerEnvironment.ts
+1
@@ -273,6 +273,7 @@ export const make = Effect.gen(function* () {
273
serverResolvedCommandContext: true,
274
threadStop: true,
275
...(hostPlatform === "win32" ? {} : { localServerStop: true }),
276
+ previewTunnelSetting: true,
277
environmentIcon: true,
278
projectCloneTracking: true,
279
projectOrganization: true,
apps/server/src/policy/ManagedPolicy.test.ts
+7
-2
@@ -60,11 +60,16 @@ it.layer(NodeServices.layer)("ManagedPolicy.load", (it) => {
60
JSON.stringify({
61
schemaVersion: 1,
62
organization: "Example Corp",
63
- limits: { webhookTasks: false, telemetry: true },
63
+ limits: { webhookTasks: false, telemetry: true, previewTunnel: false },
64
}),
65
);
66
- assert.deepEqual(policy.summary?.limits, { webhookTasks: false, telemetry: true });
66
+ assert.deepEqual(policy.summary?.limits, {
67
+ webhookTasks: false,
68
+ telemetry: true,
69
+ previewTunnel: false,
70
+ });
71
assert.equal(ManagedPolicy.deniedBy(policy, "webhookTasks"), "Example Corp");
72
+ assert.equal(ManagedPolicy.deniedBy(policy, "previewTunnel"), "Example Corp");
73
assert.isUndefined(ManagedPolicy.deniedBy(policy, "telemetry"));
74
}),
75
);
apps/server/src/policy/ManagedPolicy.ts
+3
-1
@@ -70,7 +70,7 @@ export const loadedPolicy = Effect.fn("ManagedPolicy.loadedPolicy")(function* (
70
*/
71
export function deniedBy(
72
policy: Pick<ManagedPolicy["Service"], "document">,
73
- capability: "webhookTasks" | "telemetry",
73
+ capability: "webhookTasks" | "telemetry" | "previewTunnel",
74
): string | undefined {
75
return policy.document?.limits?.[capability] === false ? policy.document.organization : undefined;
76
}
@@ -135,6 +135,7 @@ function summarizeLimits(
135
webhookTasks,
136
telemetry,
137
browserCookieImport,
138
+ previewTunnel,
139
providers,
140
updates,
141
} = document.limits ?? {};
@@ -146,6 +147,7 @@ function summarizeLimits(
147
...(webhookTasks === undefined ? {} : { webhookTasks }),
148
...(telemetry === undefined ? {} : { telemetry }),
149
...(browserCookieImport === undefined ? {} : { browserCookieImport }),
150
+ ...(previewTunnel === undefined ? {} : { previewTunnel }),
151
...(providers?.allowedDrivers === undefined && Object.keys(lockedInstanceFields).length === 0
152
? {}
153
: {
apps/server/src/policy/policyTemplates.ts
+6
@@ -119,6 +119,12 @@ const policies = (): ReadonlyArray<Policy> => [
119
help: "Disabled stops users from importing cookies from another browser into T3 Code's browser.",
120
toggle: "BrowserCookieImport",
121
},
122
+ {
123
+ id: "PreviewTunnel",
124
+ title: "Allow the preview tunnel",
125
+ help: "Disabled stops other devices from opening this machine's local servers through T3 Code: no in-app browser tabs loaded on the device, no Open on this device, no port forwarding. Browser tabs still stream from this machine.",
126
+ toggle: "PreviewTunnel",
127
+ },
128
{
129
id: "Telemetry",
130
title: "Allow usage data",
apps/server/src/preview/PreviewTunnel.test.ts
+113
-2
@@ -5,16 +5,23 @@ import {
5
AuthOrchestrationReadScope,
6
AuthSessionId,
7
AuthTerminalOperateScope,
8
+ DEFAULT_SERVER_SETTINGS,
9
+ type ManagedPolicySummary,
10
+ type ServerSettings,
11
} from "@t3tools/contracts";
12
import * as NodeNet from "node:net";
13
import * as Context from "effect/Context";
14
import * as Deferred from "effect/Deferred";
15
import * as Effect from "effect/Effect";
16
import * as Layer from "effect/Layer";
17
+import * as PubSub from "effect/PubSub";
18
+import * as Ref from "effect/Ref";
19
+import * as Stream from "effect/Stream";
20
import { HttpRouter, HttpServer } from "effect/http";
21
22
import * as EnvironmentAuth from "../auth/EnvironmentAuth.ts";
23
import * as SessionStore from "../auth/SessionStore.ts";
24
+import { ServerSettingsService } from "../serverSettings.ts";
25
import * as PreviewTunnel from "./PreviewTunnel.ts";
26
27
const listen = (onConnection: (socket: NodeNet.Socket) => void) =>
@@ -40,13 +47,51 @@ const listen = (onConnection: (socket: NodeNet.Socket) => void) =>
47
),
48
).pipe(Effect.map(({ server }) => ({ port: (server.address() as NodeNet.AddressInfo).port })));
49
50
+/** Settings the route reads; `set` publishes a change as the real service does. */
51
+const makeSettings = Effect.fn(function* (
52
+ enablePreviewTunnel = true,
53
+ managedPolicy?: ManagedPolicySummary,
54
+ /** Applied right after the first read, as a change landing while a tunnel dials. */
55
+ afterFirstRead?: Partial<ServerSettings>,
56
+) {
57
+ const current = yield* Ref.make<ServerSettings>({
58
+ ...DEFAULT_SERVER_SETTINGS,
59
+ enablePreviewTunnel,
60
+ });
61
+ const changes = yield* PubSub.unbounded<ServerSettings>();
62
+ const set = (patch: Partial<ServerSettings>) =>
63
+ Ref.updateAndGet(current, (settings) => ({ ...settings, ...patch })).pipe(
64
+ Effect.flatMap((settings) => PubSub.publish(changes, settings)),
65
+ );
66
+ let pendingChange = afterFirstRead;
67
+ return {
68
+ set,
69
+ layer: Layer.mock(ServerSettingsService, {
70
+ managedPolicy,
71
+ getSettings: Ref.get(current).pipe(
72
+ Effect.tap(() => {
73
+ const change = pendingChange;
74
+ pendingChange = undefined;
75
+ return change ? set(change) : Effect.void;
76
+ }),
77
+ ),
78
+ streamChanges: Stream.fromPubSub(changes),
79
+ subscribeChanges: PubSub.subscribe(changes).pipe(Effect.map(Stream.fromSubscription)),
80
+ }),
81
+ };
82
+});
83
+
84
/** Serves the tunnel route; `wsTicket=reader` authenticates without terminal:operate. */
44
-const serveTunnel = (sessionInvalidated: Effect.Effect<void> = Effect.never) =>
85
+const serveTunnel = (
86
+ sessionInvalidated: Effect.Effect<void> = Effect.never,
87
+ settings?: Layer.Layer<ServerSettingsService>,
88
+) =>
89
Effect.gen(function* () {
90
+ const settingsLayer = settings ?? (yield* makeSettings()).layer;
91
const services = yield* Layer.build(
92
HttpRouter.serve(PreviewTunnel.routeLayer, { disableListenLog: true }).pipe(
93
Layer.provideMerge(NodeHttpServer.layerTest),
49
- Layer.provide(PreviewTunnel.layer),
94
+ Layer.provide(PreviewTunnel.layer.pipe(Layer.provide(settingsLayer))),
95
Layer.provide(
96
Layer.mock(SessionStore.SessionStore, {
97
cookieName: "t3_session",
@@ -183,3 +228,69 @@ it.effect("closes an open tunnel when its session is revoked", () =>
228
yield* Effect.promise(() => Promise.all([clientClosed, upstreamClosed.promise]));
229
}),
230
);
231
+
232
+it.effect.each([
233
+ { case: "the setting", enabled: false, policy: undefined },
234
+ {
235
+ case: "a policy, whatever the setting",
236
+ enabled: true,
237
+ policy: {
238
+ organization: "Example Corp",
239
+ lockedSettings: [],
240
+ limits: { previewTunnel: false },
241
+ } satisfies ManagedPolicySummary,
242
+ },
243
+])("refuses every tunnel with 403 when $case turns it off", ({ enabled, policy }) =>
244
+ Effect.gen(function* () {
245
+ let dialled = 0;
246
+ const listed = yield* listen((socket) => {
247
+ dialled++;
248
+ socket.destroy();
249
+ });
250
+ const settings = yield* makeSettings(enabled, policy);
251
+ const tunnel = yield* serveTunnel(Effect.never, settings.layer);
252
+ const client = yield* openTunnel(`${tunnel.origin}/api/preview/tunnel?port=${listed.port}`);
253
+ const status = yield* Effect.promise(
254
+ () =>
255
+ new Promise<{ status: number | undefined; disabled: boolean }>((resolve, reject) => {
256
+ client.on("unexpected-response", (_request, response) =>
257
+ resolve({
258
+ status: response.statusCode,
259
+ disabled:
260
+ response.headers[PreviewTunnel.PREVIEW_TUNNEL_DISABLED_HEADER] !== undefined,
261
+ }),
262
+ );
263
+ client.on("open", () => reject(new Error("tunnel opened")));
264
+ client.on("error", reject);
265
+ }),
266
+ );
267
+ expect(status).toEqual({ status: 403, disabled: true });
268
+ expect(dialled).toBe(0);
269
+ }),
270
+);
271
+
272
+it.effect("closes an open tunnel when the setting turns it off", () =>
273
+ Effect.gen(function* () {
274
+ const upstreamClosed = Promise.withResolvers<void>();
275
+ const upstream = yield* listen((socket) => socket.on("close", () => upstreamClosed.resolve()));
276
+ const settings = yield* makeSettings();
277
+ const tunnel = yield* serveTunnel(Effect.never, settings.layer);
278
+ const client = yield* openTunnel(`${tunnel.origin}/api/preview/tunnel?port=${upstream.port}`);
279
+ yield* Effect.promise(() => new Promise((resolve) => client.once("open", resolve)));
280
+ const clientClosed = new Promise((resolve) => client.once("close", resolve));
281
+ yield* settings.set({ enablePreviewTunnel: false });
282
+ yield* Effect.promise(() => Promise.all([clientClosed, upstreamClosed.promise]));
283
+ }),
284
+);
285
+
286
+it.effect("closes a tunnel the setting turns off while it is still dialling", () =>
287
+ Effect.gen(function* () {
288
+ const settings = yield* makeSettings(true, undefined, { enablePreviewTunnel: false });
289
+ const upstreamClosed = Promise.withResolvers<void>();
290
+ const upstream = yield* listen((socket) => socket.on("close", () => upstreamClosed.resolve()));
291
+ const tunnel = yield* serveTunnel(Effect.never, settings.layer);
292
+ const client = yield* openTunnel(`${tunnel.origin}/api/preview/tunnel?port=${upstream.port}`);
293
+ const clientClosed = new Promise((resolve) => client.once("close", resolve));
294
+ yield* Effect.promise(() => Promise.all([clientClosed, upstreamClosed.promise]));
295
+ }),
296
+);
apps/server/src/preview/PreviewTunnel.ts
+54
-5
@@ -2,7 +2,7 @@
2
// connection per WebSocket. Raw bytes, so pages keep their own origin, HMR sockets and TLS.
3
import * as NodeHttpServerRequest from "@effect/platform-node/NodeHttpServerRequest";
4
import * as NodeSocket from "@effect/platform-node/NodeSocket";
5
-import { AuthTerminalOperateScope } from "@t3tools/contracts";
5
+import { allowsPreviewTunnel, AuthTerminalOperateScope } from "@t3tools/contracts";
6
import type * as NodeNet from "node:net";
7
import * as Context from "effect/Context";
8
import * as Effect from "effect/Effect";
@@ -10,12 +10,14 @@ import * as Layer from "effect/Layer";
10
import * as Option from "effect/Option";
11
import * as Schema from "effect/Schema";
12
import type * as Scope from "effect/Scope";
13
+import * as Stream from "effect/Stream";
14
import { HttpRouter, HttpServerRequest, HttpServerResponse } from "effect/http";
15
import type * as Socket from "effect/socket/Socket";
16
17
import { authenticateMediaRequest } from "../auth/http.ts";
18
import * as SessionStore from "../auth/SessionStore.ts";
19
import { requestUrl } from "../requestUrl.ts";
20
+import { ServerSettingsService } from "../serverSettings.ts";
21
22
const PREVIEW_TUNNEL_ROUTE = "/api/preview/tunnel";
23
/**
@@ -23,6 +25,8 @@ const PREVIEW_TUNNEL_ROUTE = "/api/preview/tunnel";
25
* in front of the environment answering 502 because the environment is down.
26
*/
27
export const PREVIEW_TUNNEL_PORT_REFUSED_HEADER = "x-t3-tunnel-port-refused";
28
+/** Marks a refusal because the tunnel is switched off here, by the setting or by policy. */
29
+export const PREVIEW_TUNNEL_DISABLED_HEADER = "x-t3-tunnel-disabled";
30
31
const CONNECT_TIMEOUT = "5 seconds";
32
@@ -35,6 +39,15 @@ export class PreviewTunnelPortRefusedError extends Schema.TaggedError<PreviewTun
39
}
40
}
41
42
+export class PreviewTunnelDisabledError extends Schema.TaggedError<PreviewTunnelDisabledError>()(
43
+ "PreviewTunnelDisabledError",
44
+ {},
45
+) {
46
+ override get message(): string {
47
+ return "The preview tunnel is turned off on this T3 Code server.";
48
+ }
49
+}
50
+
51
export class PreviewTunnelConnectError extends Schema.TaggedError<PreviewTunnelConnectError>()(
52
"PreviewTunnelConnectError",
53
{ port: Schema.Number, cause: Schema.Defect() },
@@ -53,13 +66,38 @@ export class PreviewTunnel extends Context.Service<
66
readonly servedPort: number | undefined;
67
}) => Effect.Effect<
68
{ readonly reader: Socket.Reader; readonly writer: Socket.Writer },
56
- PreviewTunnelPortRefusedError | PreviewTunnelConnectError,
69
+ PreviewTunnelDisabledError | PreviewTunnelPortRefusedError | PreviewTunnelConnectError,
70
Scope.Scope
71
>;
72
+ /**
73
+ * Subscribes now, before `connect` reads the setting, so a switch-off during dialling isn't
74
+ * missed. The returned effect completes once the tunnel is switched off.
75
+ */
76
+ readonly watchTurnedOff: Effect.Effect<Effect.Effect<void>, never, Scope.Scope>;
77
}
78
>()("t3/preview/PreviewTunnel") {}
79
62
-const make = Effect.sync(() => {
80
+const make = Effect.gen(function* () {
81
+ const serverSettings = yield* ServerSettingsService;
82
+ const managedPolicy = serverSettings.managedPolicy;
83
+ const allowedBy = (settings: { readonly enablePreviewTunnel: boolean }) =>
84
+ allowsPreviewTunnel({ settings, managedPolicy });
85
+ // Unreadable settings fail closed: the tunnel is raw TCP into the host.
86
+ const enabled = serverSettings.getSettings.pipe(
87
+ Effect.map(allowedBy),
88
+ Effect.orElseSucceed(() => false),
89
+ );
90
+ const watchTurnedOff = serverSettings.subscribeChanges.pipe(
91
+ Effect.map((changes) =>
92
+ changes.pipe(
93
+ Stream.filter((settings) => !allowedBy(settings)),
94
+ Stream.runHead,
95
+ // A change stream that ends without switching the tunnel off never does.
96
+ Effect.flatMap((change) => (Option.isSome(change) ? Effect.void : Effect.never)),
97
+ ),
98
+ ),
99
+ );
100
+
101
const dial = Effect.fnUntraced(function* (host: string, port: number) {
102
const socket = yield* NodeSocket.makeNet({ host, port, openTimeout: CONNECT_TIMEOUT });
103
return { reader: yield* socket.reader, writer: yield* socket.writer };
@@ -68,6 +106,7 @@ const make = Effect.sync(() => {
106
const connect: PreviewTunnel["Service"]["connect"] = Effect.fn("PreviewTunnel.connect")(
107
function* ({ port, servedPort }) {
108
yield* Effect.annotateCurrentSpan({ port });
109
+ if (!(yield* enabled)) return yield* new PreviewTunnelDisabledError();
110
// Tunnelling to this server would hand the page an unauthenticated loopback client.
111
if (port === servedPort) {
112
return yield* new PreviewTunnelPortRefusedError({ port });
@@ -79,7 +118,7 @@ const make = Effect.sync(() => {
118
},
119
);
120
82
- return PreviewTunnel.of({ connect });
121
+ return PreviewTunnel.of({ connect, watchTurnedOff });
122
});
123
124
export const layer = Layer.effect(PreviewTunnel, make);
@@ -133,23 +172,32 @@ const handler = Effect.gen(function* () {
172
const connection = NodeHttpServerRequest.toIncomingMessage(request).socket;
173
const servedPort = connection.localPort;
174
return yield* Effect.gen(function* () {
175
+ const turnedOff = yield* tunnel.watchTurnedOff;
176
// Dialled before the upgrade so a dead port fails the handshake instead of an open socket.
177
const upstream = yield* tunnel.connect({ port, servedPort });
178
const client = yield* request.upgrade;
179
const clientReader = yield* client.reader;
180
const clientWriter = yield* client.writer;
181
// A tunnel is raw TCP into the host, so it closes with its session like the RPC socket.
182
+ // So does switching the tunnel off.
183
yield* Effect.raceFirst(
184
Effect.raceFirst(
185
pump(upstream.reader, clientWriter, drained(connection)),
186
pump(clientReader, upstream.writer),
187
),
147
- sessions.awaitInvalidation(session.sessionId, session.proofKeyThumbprint),
188
+ Effect.raceFirst(
189
+ sessions.awaitInvalidation(session.sessionId, session.proofKeyThumbprint),
190
+ turnedOff,
191
+ ),
192
).pipe(Effect.ignoreCause);
193
return HttpServerResponse.empty();
194
}).pipe(
195
Effect.scoped,
196
Effect.catchTags({
197
+ PreviewTunnelDisabledError: (error) =>
198
+ Effect.succeed(
199
+ HttpServerResponse.text(error.message, { status: 403, headers: DISABLED_HEADERS }),
200
+ ),
201
PreviewTunnelPortRefusedError: (error) =>
202
Effect.succeed(
203
HttpServerResponse.text(error.message, { status: 403, headers: PORT_REFUSED_HEADERS }),
@@ -163,5 +211,6 @@ const handler = Effect.gen(function* () {
211
});
212
213
const PORT_REFUSED_HEADERS = { [PREVIEW_TUNNEL_PORT_REFUSED_HEADER]: "1" };
214
+const DISABLED_HEADERS = { [PREVIEW_TUNNEL_DISABLED_HEADER]: "1" };
215
216
export const routeLayer = HttpRouter.add("GET", PREVIEW_TUNNEL_ROUTE, handler);
apps/web/src/browser/previewRuntime.ts
+31
-3
@@ -1,6 +1,13 @@
1
import { useAtomValue } from "@effect/atom-react";
2
-import type { EnvironmentId, PreviewRuntime, PreviewSessionSnapshot } from "@t3tools/contracts";
2
+import {
3
+ allowsPreviewTunnel,
4
+ type EnvironmentId,
5
+ type PreviewRuntime,
6
+ type PreviewSessionSnapshot,
7
+} from "@t3tools/contracts";
8
+import { Atom } from "effect/reactivity";
9
10
+import { environmentCatalog } from "~/connection/catalog";
11
import { isElectron } from "~/env";
12
import { isPreviewSupportedInRuntime } from "~/previewStateStore";
13
import { appAtomRegistry } from "~/rpc/atomRegistry";
@@ -9,12 +16,27 @@ import {
16
readEnvironmentSupportsServerBrowser,
17
useEnvironmentSupportsServerBrowser,
18
} from "~/state/entities";
19
+import { environmentServerConfigsAtom } from "~/state/server";
20
+
21
+import { tunnelsEnvironmentLoopback } from "./browserTargetResolver";
22
+
23
+/** Whether this desktop loads the environment's localhost itself: it is local, or its tunnel is on. */
24
+const desktopLoadsLoopbackAtom = Atom.family((environmentId: EnvironmentId) =>
25
+ Atom.make((get) => {
26
+ const target = get(environmentCatalog.catalogValueAtom).entries.get(environmentId)?.target;
27
+ if (!tunnelsEnvironmentLoopback(target)) return true;
28
+ const config = get(environmentServerConfigsAtom).get(environmentId);
29
+ return config !== undefined && allowsPreviewTunnel(config);
30
+ }).pipe(Atom.withLabel(`preview:desktop-loads-loopback:${environmentId}`)),
31
+);
32
33
export function previewRuntimeFor(environmentId: EnvironmentId): PreviewRuntime | undefined {
34
if (!readEnvironmentSupportsServerBrowser(environmentId)) return undefined;
35
+ // Without its tunnel, another environment's tabs stream from it, as on the web.
36
if (
37
isPreviewSupportedInRuntime() &&
17
- environmentId !== appAtomRegistry.get(primaryEnvironmentIdAtom)
38
+ environmentId !== appAtomRegistry.get(primaryEnvironmentIdAtom) &&
39
+ appAtomRegistry.get(desktopLoadsLoopbackAtom(environmentId))
40
) {
41
return undefined;
42
}
@@ -25,11 +47,17 @@ export function alternatePreviewRuntime(
47
environmentId: EnvironmentId,
48
primaryEnvironmentId: EnvironmentId | null,
49
serverBrowser: boolean,
50
+ desktopLoadsLoopback: boolean,
51
snapshot: Pick<PreviewSessionSnapshot, "runtime"> | null | undefined,
52
): PreviewRuntime | null {
53
if (!snapshot || !serverBrowser || !isPreviewSupportedInRuntime()) return null;
54
if (environmentId === primaryEnvironmentId) return null;
32
- return snapshot.runtime === "server" ? "desktop" : "server";
55
+ if (snapshot.runtime === "server") return desktopLoadsLoopback ? "desktop" : null;
56
+ return "server";
57
+}
58
+
59
+export function useDesktopLoadsLoopback(environmentId: EnvironmentId): boolean {
60
+ return useAtomValue(desktopLoadsLoopbackAtom(environmentId));
61
}
62
63
export function isPreviewAvailableFor(environmentId: EnvironmentId): boolean {
apps/web/src/components/CommandPalettePortForwardItems.tsx
+1
-2
@@ -54,8 +54,7 @@ export function useCommandPalettePortForwardItem(input: {
54
const forwards = usePortForwards();
55
const { environments } = useEnvironments();
56
const reachable = environments.filter(
57
- (environment) =>
58
- environment.connection.phase === "connected" && canForwardPorts(environment.entry.target),
57
+ (environment) => environment.connection.phase === "connected" && canForwardPorts(environment),
58
);
59
const tunnelling = useEnvironmentsWithScope(reachable, AuthTerminalOperateScope);
60
const tunnelled = reachable.filter((environment) => tunnelling.has(environment.environmentId));
apps/web/src/components/chat/ThreadServersPanel.tsx
+23
-2
@@ -12,12 +12,16 @@ import {
12
isAtomCommandInterrupted,
13
squashAtomCommandFailure,
14
} from "@t3tools/client-runtime/state/runtime";
15
+import { isLoopbackHost } from "@t3tools/shared/preview";
16
import { T, useGT, Var } from "gt-react";
17
import { m } from "~/i18n/messages";
18
import { CableIcon, GlobeIcon, SquareIcon, ChevronDownIcon, ChevronUpIcon } from "lucide-react";
19
import { type MouseEvent, useState } from "react";
20
20
-import { resolveExternalServerUrl } from "../../browser/browserTargetResolver";
21
+import {
22
+ resolveExternalServerUrl,
23
+ tunnelsEnvironmentLoopback,
24
+} from "../../browser/browserTargetResolver";
25
import { readLocalApi } from "../../localApi";
26
import { cn, isMacPlatform } from "../../lib/utils";
27
import { useThreadDiscoveredPorts } from "../../portDiscoveryState";
@@ -69,7 +73,7 @@ function ThreadServersList(props: ThreadServersPanelProps) {
73
const forwardable =
74
useEnvironmentScope(props.environmentId, AuthTerminalOperateScope) &&
75
environment?.connection.phase === "connected" &&
72
- canForwardPorts(environment.entry.target);
76
+ canForwardPorts(environment);
77
const locality = useForwardLocality(forwardable ? props.environmentId : null);
78
const canForward = locality === "remote";
79
const openPreview = useAtomCommand(previewEnvironment.open, { reportFailure: false });
@@ -113,6 +117,23 @@ function ThreadServersList(props: ThreadServersPanelProps) {
117
)
118
: resolveExternalServerUrl(props.environmentId, server.url);
119
if (url === null) return;
120
+ // Without a forward, a remote environment's localhost would open this machine's instead.
121
+ if (
122
+ locality !== "local" &&
123
+ tunnelsEnvironmentLoopback(environment?.entry.target) &&
124
+ isLoopbackHost(new URL(url).hostname)
125
+ ) {
126
+ reportFailure(
127
+ gt("Unable to open in browser"),
128
+ new Error(
129
+ gt(
130
+ "localhost:{port} runs on another machine, and port forwarding isn't available for it right now.",
131
+ { port: server.port },
132
+ ),
133
+ ),
134
+ );
135
+ return;
136
+ }
137
await readLocalApi()
138
?.shell.openExternal(url)
139
.catch((error: unknown) => reportFailure(gt("Unable to open in browser"), error));
apps/web/src/components/preview/PreviewView.tsx
+7
-1
@@ -91,7 +91,11 @@ import type { MessageResolver } from "~/i18n/messages";
91
import { revealInFileExplorerLabel } from "./fileExplorerLabel";
92
import { Badge } from "~/components/ui/badge";
93
import { BrowserSurfaceSlot } from "~/browser/BrowserSurfaceSlot";
94
-import { alternatePreviewRuntime, useRendersServerTabNatively } from "~/browser/previewRuntime";
94
+import {
95
+ alternatePreviewRuntime,
96
+ useDesktopLoadsLoopback,
97
+ useRendersServerTabNatively,
98
+} from "~/browser/previewRuntime";
99
import { ServerBrowserSurface, type ServerBrowserHandle } from "~/browser/ServerBrowserSurface";
100
import { cn } from "~/lib/utils";
101
import { useBrowserSurfaceStore } from "~/browser/browserSurfaceStore";
@@ -205,6 +209,7 @@ export function PreviewView({
209
const environmentLabel = useEnvironment(threadRef.environmentId)?.label ?? null;
210
const primaryEnvironmentId = usePrimaryEnvironmentId();
211
const serverBrowser = useEnvironmentSupportsServerBrowser(threadRef.environmentId);
212
+ const desktopLoadsLoopback = useDesktopLoadsLoopback(threadRef.environmentId);
213
const adjust = useAtomCommand(previewEnvironment.adjust, "preview appearance or zoom");
214
215
usePreviewSession(threadRef);
@@ -463,6 +468,7 @@ export function PreviewView({
468
threadRef.environmentId,
469
primaryEnvironmentId,
470
serverBrowser,
471
+ desktopLoadsLoopback,
472
snapshot,
473
);
474
const moveLabel =
apps/web/src/components/settings/ConnectionsSettings.tsx
+27
@@ -13,6 +13,8 @@ import {
13
AuthEnvironmentMaintainScope,
14
AuthRelayReadScope,
15
AuthRelayWriteScope,
16
+ allowsPreviewTunnel,
17
+ isManagedSettingPath,
18
type AuthClientSession,
19
type AuthPairingLink,
20
type AuthPairingCredentialResult,
@@ -1255,6 +1257,12 @@ function ConnectionsSettingsContent({
1257
);
1258
1259
const accessServerConfig = accessEnvironment?.serverConfig ?? null;
1260
+ const accessPolicy = accessServerConfig?.managedPolicy;
1261
+ const previewTunnelDenial =
1262
+ managedCapabilityDenial(accessPolicy, "previewTunnel", m) ??
1263
+ (accessPolicy !== undefined && isManagedSettingPath(accessPolicy, "enablePreviewTunnel")
1264
+ ? gt("Managed by {organization}.", { organization: accessPolicy.organization })
1265
+ : undefined);
1266
const primarySettings = (
1267
<>
1268
{accessEnvironmentPicker}
@@ -1377,6 +1385,25 @@ function ConnectionsSettingsContent({
1385
}
1386
/>
1387
) : null}
1388
+ {accessServerConfig?.environment.capabilities.previewTunnelSetting ? (
1389
+ <SettingsRow
1390
+ title={searchableSetting("preview-tunnel").title}
1391
+ description={gt(
1392
+ "Lets other devices open this machine's local servers: browser tabs loaded on the device, Open on this device, and port forwarding. Off: browser tabs stream from this machine.",
1393
+ )}
1394
+ managed={previewTunnelDenial}
1395
+ control={
1396
+ <Switch
1397
+ checked={allowsPreviewTunnel(accessServerConfig)}
1398
+ disabled={!canWriteAccess}
1399
+ aria-label={gt("Allow the preview tunnel")}
1400
+ onCheckedChange={(enabled) =>
1401
+ void updateAccessSettings({ enablePreviewTunnel: enabled })
1402
+ }
1403
+ />
1404
+ }
1405
+ />
1406
+ ) : null}
1407
{accessEnvironment ? (
1408
<details className="group px-3 sm:px-4">
1409
<summary className="flex min-h-11 cursor-pointer list-none items-center gap-2 rounded-md text-sm font-medium outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring [&::-webkit-details-marker]:hidden">
apps/web/src/components/settings/settingsSearch.ts
+9
@@ -1391,6 +1391,15 @@ export const SETTINGS_SEARCH_ITEMS = [
1391
searchTerms: [msg("mobile push notifications live activities cloud tunnel")],
1392
cloudOnly: true,
1393
},
1394
+ {
1395
+ id: "preview-tunnel",
1396
+ title: msg("Preview tunnel"),
1397
+ to: "/settings/access",
1398
+ targetId: "connections-environment",
1399
+ searchTerms: [
1400
+ msg("localhost loopback port forwarding open on this device browser tabs stream security"),
1401
+ ],
1402
+ },
1403
{
1404
id: "connections-environment",
1405
title: msg("This machine"),
apps/web/src/i18n/translations/de.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "Die Richtlinie von {organization} erlaubt T3 Connect nicht.",
24
"986b0873f913a840": "Die Richtlinie von {organization} erlaubt keine Webhook-Aufgaben.",
25
"eebc538e25b09fe2": "Die Richtlinie von {organization} erlaubt keinen Import von Browser-Cookies.",
26
+ "7642a133db05f164": "Die Richtlinie von {organization} erlaubt nicht, die lokalen Server dieses Rechners auf anderen Geräten zu öffnen.",
27
"39f6771b49f9b3b6": "Standard verwenden",
28
"45bb0e90e1c42046": "Wenn du zurückkommst",
29
"d8fa0a55446bbb0d": "Bevor der Cache abläuft (Beta)",
@@ -4198,6 +4199,7 @@
4199
"075398ac562d74b0": "Agentensitzung trennen",
4200
"1d2025060ba3d1c3": "Port {port} konnte nicht weitergeleitet werden",
4201
"086ecbb6f4c2e959": "Kann nicht im Browser geöffnet werden",
4202
+ "112173d046bfc910": "localhost:{port} läuft auf einem anderen Rechner, und Portweiterleitung ist dafür gerade nicht verfügbar.",
4203
"51052c00ab1ac8cc": "Vorschau kann nicht geöffnet werden",
4204
"0ccd37739f9cf2b6": "Server konnte nicht gestoppt werden",
4205
"a610a81c4061bb4c": "Server",
@@ -8006,6 +8008,8 @@
8008
"9bfddd9a835be5de": "Server",
8009
"43b545c01503eee4": "Update wiederholen",
8010
"2f015e6d5459dce9": "Auf {version} aktualisieren",
8011
+ "8ebba639f92932c3": "Erlaubt anderen Geräten, die lokalen Server dieses Rechners zu öffnen: auf dem Gerät geladene Browser-Tabs, Auf diesem Gerät öffnen und Portweiterleitung. Aus: Browser-Tabs werden von diesem Rechner gestreamt.",
8012
+ "1c5266bf18d0ed24": "Vorschau-Tunnel erlauben",
8013
"a0e93cca71d0417e": "Autorisierte Clients",
8014
"03b9501ae07b5cf3": "Netzwerkzugriff aktivieren?",
8015
"a09aff32ef3d89c7": "Netzwerkzugriff deaktivieren?",
@@ -11630,6 +11634,8 @@
11634
"b5cd79513a06e7c3": "Webhooks offline zurückhalten",
11635
"fadd0fcd7b9e1651": "webhook automatisierungen offline warteschlange postfach t3 connect",
11636
"9bebacdcfbde18d4": "mobil push-benachrichtigungen live-aktivitäten cloud tunnel",
11637
+ "a4e6dee662edc3cf": "Vorschau-Tunnel",
11638
+ "8ed7c2a2226f4663": "localhost loopback portweiterleitung auf diesem gerät öffnen browser tabs streamen sicherheit port forwarding",
11639
"1c3e0ac06c8a1f1e": "verbindungen server backend lokal remote zugriff administrativ berechtigungen bereich kopplungslinks qr-code autorisierte clients sitzungen widerrufen endpunkt",
11640
"744fd34e8049efeb": "verknüpfen peer anderer rechner vps agenten dort arbeiten übergabe kopplungscode",
11641
"3d00c452287f50bd": "hinzufügen koppeln backend host code ssh konfiguration agent tunnel gespeichert t3 connect",
apps/web/src/i18n/translations/en.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization}'s policy does not allow T3 Connect.",
24
"986b0873f913a840": "{organization}'s policy does not allow webhook tasks.",
25
"eebc538e25b09fe2": "{organization}'s policy does not allow importing browser cookies.",
26
+ "7642a133db05f164": "{organization}'s policy does not allow opening this machine's local servers on other devices.",
27
"39f6771b49f9b3b6": "Use default",
28
"45bb0e90e1c42046": "When you return",
29
"d8fa0a55446bbb0d": "Before the cache expires (beta)",
@@ -4197,6 +4198,7 @@
4198
"075398ac562d74b0": "Disconnect agent session",
4199
"1d2025060ba3d1c3": "Could not forward port {port}",
4200
"086ecbb6f4c2e959": "Unable to open in browser",
4201
+ "112173d046bfc910": "localhost:{port} runs on another machine, and port forwarding isn't available for it right now.",
4202
"51052c00ab1ac8cc": "Unable to open preview",
4203
"0ccd37739f9cf2b6": "Could not stop server",
4204
"a610a81c4061bb4c": "Servers",
@@ -8013,6 +8015,8 @@
8015
"9bfddd9a835be5de": "server",
8016
"43b545c01503eee4": "Retry update",
8017
"2f015e6d5459dce9": "Update to {version}",
8018
+ "8ebba639f92932c3": "Lets other devices open this machine's local servers: browser tabs loaded on the device, Open on this device, and port forwarding. Off: browser tabs stream from this machine.",
8019
+ "1c5266bf18d0ed24": "Allow the preview tunnel",
8020
"a0e93cca71d0417e": "Authorized clients",
8021
"03b9501ae07b5cf3": "Enable network access?",
8022
"a09aff32ef3d89c7": "Disable network access?",
@@ -11638,6 +11642,8 @@
11642
"b5cd79513a06e7c3": "Hold webhooks while offline",
11643
"fadd0fcd7b9e1651": "webhook automations offline queue mailbox t3 connect",
11644
"9bebacdcfbde18d4": "mobile push notifications live activities cloud tunnel",
11645
+ "a4e6dee662edc3cf": "Preview tunnel",
11646
+ "8ed7c2a2226f4663": "localhost loopback port forwarding open on this device browser tabs stream security",
11647
"1c3e0ac06c8a1f1e": "connections server backend local remote access administrative permissions scope pairing links qr code authorized clients sessions revoke endpoint",
11648
"744fd34e8049efeb": "link peer another machine vps agents work there handoff pairing code",
11649
"3d00c452287f50bd": "add pair backend host code ssh config agent tunnel saved t3 connect",
apps/web/src/i18n/translations/es.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "La política de {organization} no permite T3 Connect.",
24
"986b0873f913a840": "La política de {organization} no permite tareas de webhook.",
25
"eebc538e25b09fe2": "La política de {organization} no permite importar cookies del navegador.",
26
+ "7642a133db05f164": "La política de {organization} no permite abrir los servidores locales de esta máquina en otros dispositivos.",
27
"39f6771b49f9b3b6": "Usar valor predeterminado",
28
"45bb0e90e1c42046": "Cuando vuelvas",
29
"d8fa0a55446bbb0d": "Antes de que caduque la caché (beta)",
@@ -4195,6 +4196,7 @@
4196
"075398ac562d74b0": "Desconectar la sesión del agente",
4197
"1d2025060ba3d1c3": "No se pudo reenviar el puerto {port}",
4198
"086ecbb6f4c2e959": "No se puede abrir en el navegador",
4199
+ "112173d046bfc910": "localhost:{port} se ejecuta en otro equipo y el reenvío de puertos no está disponible para él ahora.",
4200
"51052c00ab1ac8cc": "No se puede abrir la vista previa",
4201
"0ccd37739f9cf2b6": "No se pudo detener el servidor",
4202
"a610a81c4061bb4c": "Servidores",
@@ -8005,6 +8007,8 @@
8007
"9bfddd9a835be5de": "servidor",
8008
"43b545c01503eee4": "Reintentar actualización",
8009
"2f015e6d5459dce9": "Actualizar a {version}",
8010
+ "8ebba639f92932c3": "Permite que otros dispositivos abran los servidores locales de esta máquina: pestañas del navegador cargadas en el dispositivo, Abrir en este dispositivo y reenvío de puertos. Desactivado: las pestañas del navegador se transmiten desde esta máquina.",
8011
+ "1c5266bf18d0ed24": "Permitir el túnel de vista previa",
8012
"a0e93cca71d0417e": "Clientes autorizados",
8013
"03b9501ae07b5cf3": "¿Activar el acceso a la red?",
8014
"a09aff32ef3d89c7": "¿Desactivar el acceso a la red?",
@@ -11623,6 +11627,8 @@
11627
"b5cd79513a06e7c3": "Retener webhooks sin conexión",
11628
"fadd0fcd7b9e1651": "webhook automatizaciones sin conexión cola buzón t3 connect",
11629
"9bebacdcfbde18d4": "móvil notificaciones push actividades en directo live activities nube túnel",
11630
+ "a4e6dee662edc3cf": "Túnel de vista previa",
11631
+ "8ed7c2a2226f4663": "localhost loopback reenvío de puertos abrir en este dispositivo pestañas navegador transmitir seguridad port forwarding",
11632
"1c3e0ac06c8a1f1e": "conexiones servidor backend local remoto acceso administrativo permisos ámbito enlaces de emparejamiento código qr clientes autorizados sesiones revocar endpoint",
11633
"744fd34e8049efeb": "vincular par otra máquina vps agentes trabajar allí traspaso código de emparejamiento",
11634
"3d00c452287f50bd": "añadir emparejar backend host código ssh config agente túnel guardado t3 connect",
apps/web/src/i18n/translations/fr.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "La politique de {organization} n’autorise pas T3 Connect.",
24
"986b0873f913a840": "La politique de {organization} n’autorise pas les tâches webhook.",
25
"eebc538e25b09fe2": "La politique de {organization} n’autorise pas l’import des cookies du navigateur.",
26
+ "7642a133db05f164": "La stratégie de {organization} n’autorise pas l’ouverture des serveurs locaux de cette machine sur d’autres appareils.",
27
"39f6771b49f9b3b6": "Utiliser la valeur par défaut",
28
"45bb0e90e1c42046": "À votre retour",
29
"d8fa0a55446bbb0d": "Avant l’expiration du cache (bêta)",
@@ -4196,6 +4197,7 @@
4197
"075398ac562d74b0": "Déconnecter la session de l’agent",
4198
"1d2025060ba3d1c3": "Impossible de rediriger le port {port}",
4199
"086ecbb6f4c2e959": "Impossible d’ouvrir dans le navigateur",
4200
+ "112173d046bfc910": "localhost:{port} tourne sur une autre machine, et la redirection de ports n’est pas disponible pour elle pour le moment.",
4201
"51052c00ab1ac8cc": "Impossible d’ouvrir l’aperçu",
4202
"0ccd37739f9cf2b6": "Impossible d’arrêter le serveur",
4203
"a610a81c4061bb4c": "Serveurs",
@@ -8006,6 +8008,8 @@
8008
"9bfddd9a835be5de": "serveur",
8009
"43b545c01503eee4": "Réessayer la mise à jour",
8010
"2f015e6d5459dce9": "Mettre à jour vers {version}",
8011
+ "8ebba639f92932c3": "Permet à d’autres appareils d’ouvrir les serveurs locaux de cette machine : onglets de navigateur chargés sur l’appareil, Ouvrir sur cet appareil et redirection de ports. Désactivé : les onglets du navigateur sont diffusés depuis cette machine.",
8012
+ "1c5266bf18d0ed24": "Autoriser le tunnel d’aperçu",
8013
"a0e93cca71d0417e": "Clients autorisés",
8014
"03b9501ae07b5cf3": "Activer l’accès réseau ?",
8015
"a09aff32ef3d89c7": "Désactiver l’accès réseau ?",
@@ -11628,6 +11632,8 @@
11632
"b5cd79513a06e7c3": "Conserver les webhooks hors ligne",
11633
"fadd0fcd7b9e1651": "webhook automatisations file d’attente hors ligne boîte aux lettres t3 connect",
11634
"9bebacdcfbde18d4": "mobile notifications push live activities tunnel cloud",
11635
+ "a4e6dee662edc3cf": "Tunnel d’aperçu",
11636
+ "8ed7c2a2226f4663": "localhost loopback redirection de ports ouvrir sur cet appareil onglets navigateur diffusion sécurité port forwarding",
11637
"1c3e0ac06c8a1f1e": "connexions serveur backend local accès distant autorisations administratives portée liens d’appairage code qr clients autorisés sessions révoquer point de terminaison",
11638
"744fd34e8049efeb": "associer pair autre machine vps agents y travaillent transfert code d’appairage",
11639
"3d00c452287f50bd": "ajouter appairer backend hôte code ssh config agent tunnel enregistré t3 connect",
apps/web/src/i18n/translations/ja.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization} のポリシーでは、T3 Connect は許可されていません。",
24
"986b0873f913a840": "{organization} のポリシーでは、Webhook タスクは許可されていません。",
25
"eebc538e25b09fe2": "{organization} のポリシーでは、ブラウザーの Cookie のインポートは許可されていません。",
26
+ "7642a133db05f164": "{organization} のポリシーでは、このマシンのローカルサーバーを他のデバイスで開くことは許可されていません。",
27
"39f6771b49f9b3b6": "デフォルトを使用",
28
"45bb0e90e1c42046": "戻ってきたとき",
29
"d8fa0a55446bbb0d": "キャッシュの期限切れ前 (ベータ)",
@@ -4186,6 +4187,7 @@
4187
"075398ac562d74b0": "エージェントのセッションを切断",
4188
"1d2025060ba3d1c3": "ポート {port} を転送できませんでした",
4189
"086ecbb6f4c2e959": "ブラウザーで開けません",
4190
+ "112173d046bfc910": "localhost:{port} は別のマシンで動いており、現在このポートは転送できません。",
4191
"51052c00ab1ac8cc": "プレビューを開けません",
4192
"0ccd37739f9cf2b6": "サーバーを停止できませんでした",
4193
"a610a81c4061bb4c": "サーバー",
@@ -7966,6 +7968,8 @@
7968
"9bfddd9a835be5de": "サーバー",
7969
"43b545c01503eee4": "更新を再試行",
7970
"2f015e6d5459dce9": "{version} に更新",
7971
+ "8ebba639f92932c3": "他のデバイスがこのマシンのローカルサーバーを開けるようにします:デバイス上で読み込むブラウザタブ、「このデバイスで開く」、ポートフォワーディング。オフ:ブラウザタブはこのマシンからストリーミングされます。",
7972
+ "1c5266bf18d0ed24": "プレビュートンネルを許可",
7973
"a0e93cca71d0417e": "承認済みクライアント",
7974
"03b9501ae07b5cf3": "ネットワークアクセスを有効にしますか?",
7975
"a09aff32ef3d89c7": "ネットワークアクセスを無効にしますか?",
@@ -11578,6 +11582,8 @@
11582
"b5cd79513a06e7c3": "オフライン中の Webhook を保持",
11583
"fadd0fcd7b9e1651": "Webhook オートメーション オフライン キュー メールボックス T3 Connect webhook",
11584
"9bebacdcfbde18d4": "モバイル プッシュ通知 ライブアクティビティ クラウド トンネル push",
11585
+ "a4e6dee662edc3cf": "プレビュートンネル",
11586
+ "8ed7c2a2226f4663": "localhost ループバック ポートフォワーディング このデバイスで開く ブラウザ タブ ストリーミング セキュリティ port forwarding",
11587
"1c3e0ac06c8a1f1e": "接続 サーバー バックエンド ローカル リモート アクセス 管理者 権限 スコープ ペアリングリンク QR コード 認可済みクライアント セッション 取り消し エンドポイント connections",
11588
"744fd34e8049efeb": "リンク ピア 別のマシン VPS エージェント そこで作業 引き継ぎ ペアリングコード link machine",
11589
"3d00c452287f50bd": "追加 ペアリング バックエンド ホスト コード SSH 構成 エージェント トンネル 保存済み T3 Connect add pair",
apps/web/src/i18n/translations/ko.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization}의 정책상 T3 Connect를 사용할 수 없습니다.",
24
"986b0873f913a840": "{organization}의 정책상 웹후크 작업을 사용할 수 없습니다.",
25
"eebc538e25b09fe2": "{organization}의 정책상 브라우저 쿠키를 가져올 수 없습니다.",
26
+ "7642a133db05f164": "{organization}의 정책은 이 컴퓨터의 로컬 서버를 다른 기기에서 여는 것을 허용하지 않습니다.",
27
"39f6771b49f9b3b6": "기본값 사용",
28
"45bb0e90e1c42046": "돌아왔을 때",
29
"d8fa0a55446bbb0d": "캐시가 만료되기 전(베타)",
@@ -4183,6 +4184,7 @@
4184
"075398ac562d74b0": "에이전트 세션 연결 끊기",
4185
"1d2025060ba3d1c3": "포트 {port}을(를) 포워딩할 수 없습니다",
4186
"086ecbb6f4c2e959": "브라우저에서 열 수 없습니다",
4187
+ "112173d046bfc910": "localhost:{port}는 다른 컴퓨터에서 실행 중이며, 지금은 포트 포워딩을 사용할 수 없습니다.",
4188
"51052c00ab1ac8cc": "미리 보기를 열 수 없습니다",
4189
"0ccd37739f9cf2b6": "서버를 중지할 수 없습니다",
4190
"a610a81c4061bb4c": "서버",
@@ -7968,6 +7970,8 @@
7970
"9bfddd9a835be5de": "서버",
7971
"43b545c01503eee4": "업데이트 다시 시도",
7972
"2f015e6d5459dce9": "{version}(으)로 업데이트",
7973
+ "8ebba639f92932c3": "다른 기기에서 이 컴퓨터의 로컬 서버를 열 수 있게 합니다: 기기에서 불러오는 브라우저 탭, 이 기기에서 열기, 포트 포워딩. 끄면 브라우저 탭이 이 컴퓨터에서 스트리밍됩니다.",
7974
+ "1c5266bf18d0ed24": "미리보기 터널 허용",
7975
"a0e93cca71d0417e": "승인된 클라이언트",
7976
"03b9501ae07b5cf3": "네트워크 액세스를 켤까요?",
7977
"a09aff32ef3d89c7": "네트워크 액세스를 끌까요?",
@@ -11575,6 +11579,8 @@
11579
"b5cd79513a06e7c3": "오프라인 동안 웹후크 보관",
11580
"fadd0fcd7b9e1651": "웹후크 자동화 오프라인 대기열 메일함 T3 Connect",
11581
"9bebacdcfbde18d4": "모바일 푸시 알림 실시간 현황 클라우드 터널",
11582
+ "a4e6dee662edc3cf": "미리보기 터널",
11583
+ "8ed7c2a2226f4663": "localhost 루프백 포트 포워딩 이 기기에서 열기 브라우저 탭 스트리밍 보안 port forwarding",
11584
"1c3e0ac06c8a1f1e": "연결 서버 백엔드 로컬 원격 액세스 관리 권한 범위 페어링 링크 QR 코드 인증된 클라이언트 세션 취소 엔드포인트",
11585
"744fd34e8049efeb": "다른 머신 연결 피어 vps 에이전트 원격 작업 넘기기 페어링 코드",
11586
"3d00c452287f50bd": "추가 페어링 백엔드 호스트 코드 ssh 구성 에이전트 터널 저장됨 T3 Connect",
apps/web/src/i18n/translations/pt-BR.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "A política de {organization} não permite o T3 Connect.",
24
"986b0873f913a840": "A política de {organization} não permite tarefas de webhook.",
25
"eebc538e25b09fe2": "A política de {organization} não permite importar cookies do navegador.",
26
+ "7642a133db05f164": "A política de {organization} não permite abrir os servidores locais desta máquina em outros dispositivos.",
27
"39f6771b49f9b3b6": "Usar padrão",
28
"45bb0e90e1c42046": "Quando você voltar",
29
"d8fa0a55446bbb0d": "Antes de o cache expirar (beta)",
@@ -4195,6 +4196,7 @@
4196
"075398ac562d74b0": "Desconectar a sessão do agente",
4197
"1d2025060ba3d1c3": "Não foi possível encaminhar a porta {port}",
4198
"086ecbb6f4c2e959": "Não foi possível abrir no navegador",
4199
+ "112173d046bfc910": "localhost:{port} roda em outra máquina, e o encaminhamento de portas não está disponível para ela agora.",
4200
"51052c00ab1ac8cc": "Não foi possível abrir a pré-visualização",
4201
"0ccd37739f9cf2b6": "Não foi possível parar o servidor",
4202
"a610a81c4061bb4c": "Servidores",
@@ -8005,6 +8007,8 @@
8007
"9bfddd9a835be5de": "servidor",
8008
"43b545c01503eee4": "Tentar atualizar novamente",
8009
"2f015e6d5459dce9": "Atualizar para {version}",
8010
+ "8ebba639f92932c3": "Permite que outros dispositivos abram os servidores locais desta máquina: abas do navegador carregadas no dispositivo, Abrir neste dispositivo e encaminhamento de portas. Desativado: as abas do navegador são transmitidas desta máquina.",
8011
+ "1c5266bf18d0ed24": "Permitir o túnel de pré-visualização",
8012
"a0e93cca71d0417e": "Clientes autorizados",
8013
"03b9501ae07b5cf3": "Ativar o acesso à rede?",
8014
"a09aff32ef3d89c7": "Desativar o acesso à rede?",
@@ -11627,6 +11631,8 @@
11631
"b5cd79513a06e7c3": "Reter webhooks enquanto offline",
11632
"fadd0fcd7b9e1651": "webhook automações offline fila caixa de correio t3 connect",
11633
"9bebacdcfbde18d4": "celular notificações push live activities nuvem túnel",
11634
+ "a4e6dee662edc3cf": "Túnel de pré-visualização",
11635
+ "8ed7c2a2226f4663": "localhost loopback encaminhamento de portas abrir neste dispositivo abas navegador transmitir segurança port forwarding",
11636
"1c3e0ac06c8a1f1e": "conexões servidor backend local remoto acesso administrativo permissões escopo links de pareamento código qr clientes autorizados sessões revogar endpoint",
11637
"744fd34e8049efeb": "vincular par outra máquina vps agentes trabalham lá transferir código de pareamento",
11638
"3d00c452287f50bd": "adicionar parear backend host código ssh config agente túnel salvo t3 connect",
apps/web/src/i18n/translations/ru.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "Политика {organization} запрещает T3 Connect.",
24
"986b0873f913a840": "Политика {organization} запрещает задачи по вебхуку.",
25
"eebc538e25b09fe2": "Политика {organization} запрещает импорт cookie браузера.",
26
+ "7642a133db05f164": "Политика {organization} не разрешает открывать локальные серверы этого компьютера на других устройствах.",
27
"39f6771b49f9b3b6": "По умолчанию",
28
"45bb0e90e1c42046": "Когда вы вернётесь",
29
"d8fa0a55446bbb0d": "До истечения кеша (бета)",
@@ -4195,6 +4196,7 @@
4196
"075398ac562d74b0": "Отключить сеанс агента",
4197
"1d2025060ba3d1c3": "Не удалось перенаправить порт {port}",
4198
"086ecbb6f4c2e959": "Не удалось открыть в браузере",
4199
+ "112173d046bfc910": "localhost:{port} работает на другом компьютере, и перенаправление портов для него сейчас недоступно.",
4200
"51052c00ab1ac8cc": "Не удалось открыть предпросмотр",
4201
"0ccd37739f9cf2b6": "Не удалось остановить сервер",
4202
"a610a81c4061bb4c": "Серверы",
@@ -8005,6 +8007,8 @@
8007
"9bfddd9a835be5de": "сервер",
8008
"43b545c01503eee4": "Повторить обновление",
8009
"2f015e6d5459dce9": "Обновить до {version}",
8010
+ "8ebba639f92932c3": "Позволяет другим устройствам открывать локальные серверы этого компьютера: вкладки браузера, загружаемые на устройстве, «Открыть на этом устройстве» и перенаправление портов. Выключено: вкладки браузера транслируются с этого компьютера.",
8011
+ "1c5266bf18d0ed24": "Разрешить туннель предпросмотра",
8012
"a0e93cca71d0417e": "Авторизованные клиенты",
8013
"03b9501ae07b5cf3": "Включить сетевой доступ?",
8014
"a09aff32ef3d89c7": "Отключить сетевой доступ?",
@@ -11628,6 +11632,8 @@
11632
"b5cd79513a06e7c3": "Удерживать вебхуки в офлайне",
11633
"fadd0fcd7b9e1651": "вебхук автоматизации офлайн очередь почтовый ящик t3 connect",
11634
"9bebacdcfbde18d4": "мобильные push-уведомления live activities облако туннель",
11635
+ "a4e6dee662edc3cf": "Туннель предпросмотра",
11636
+ "8ed7c2a2226f4663": "localhost loopback перенаправление портов открыть на этом устройстве вкладки браузер трансляция безопасность port forwarding",
11637
"1c3e0ac06c8a1f1e": "подключения сервер бэкенд локальный удалённый доступ административные разрешения область ссылки сопряжения qr-код авторизованные клиенты сеансы отозвать конечная точка",
11638
"744fd34e8049efeb": "привязать другой компьютер vps агенты работают там передача код сопряжения",
11639
"3d00c452287f50bd": "добавить сопряжение бэкенд хост код ssh конфигурация агент туннель сохранённые t3 connect",
apps/web/src/i18n/translations/sv.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "Policyn för {organization} tillåter inte T3 Connect.",
24
"986b0873f913a840": "Policyn för {organization} tillåter inte webhook-uppgifter.",
25
"eebc538e25b09fe2": "Policyn för {organization} tillåter inte import av cookies från webbläsare.",
26
+ "7642a133db05f164": "{organization}s policy tillåter inte att den här datorns lokala servrar öppnas på andra enheter.",
27
"39f6771b49f9b3b6": "Använd standard",
28
"45bb0e90e1c42046": "När du kommer tillbaka",
29
"d8fa0a55446bbb0d": "Innan cachen går ut (beta)",
@@ -4196,6 +4197,7 @@
4197
"075398ac562d74b0": "Koppla från agentsession",
4198
"1d2025060ba3d1c3": "Kunde inte vidarebefordra port {port}",
4199
"086ecbb6f4c2e959": "Det gick inte att öppna i webbläsaren",
4200
+ "112173d046bfc910": "localhost:{port} körs på en annan dator, och portvidarebefordring är inte tillgänglig för den just nu.",
4201
"51052c00ab1ac8cc": "Det gick inte att öppna förhandsvisningen",
4202
"0ccd37739f9cf2b6": "Kunde inte stoppa servern",
4203
"a610a81c4061bb4c": "Servrar",
@@ -8011,6 +8013,8 @@
8013
"9bfddd9a835be5de": "server",
8014
"43b545c01503eee4": "Försök uppdatera igen",
8015
"2f015e6d5459dce9": "Uppdatera till {version}",
8016
+ "8ebba639f92932c3": "Låter andra enheter öppna den här datorns lokala servrar: webbläsarflikar som läses in på enheten, Öppna på den här enheten och portvidarebefordran. Av: webbläsarflikar strömmas från den här datorn.",
8017
+ "1c5266bf18d0ed24": "Tillåt förhandsgranskningstunneln",
8018
"a0e93cca71d0417e": "Auktoriserade klienter",
8019
"03b9501ae07b5cf3": "Aktivera nätverksåtkomst?",
8020
"a09aff32ef3d89c7": "Inaktivera nätverksåtkomst?",
@@ -11636,6 +11640,8 @@
11640
"b5cd79513a06e7c3": "Håll kvar webhooks i offlineläge",
11641
"fadd0fcd7b9e1651": "webhook automatiseringar offline kö brevlåda t3 connect",
11642
"9bebacdcfbde18d4": "mobil pushaviseringar liveaktiviteter live activities moln tunnel",
11643
+ "a4e6dee662edc3cf": "Förhandsgranskningstunnel",
11644
+ "8ed7c2a2226f4663": "localhost loopback portvidarebefordran öppna på den här enheten webbläsarflikar strömma säkerhet port forwarding",
11645
"1c3e0ac06c8a1f1e": "anslutningar server backend lokal fjärråtkomst administrativa behörigheter omfång parkopplingslänkar qr-kod auktoriserade klienter sessioner återkalla slutpunkt",
11646
"744fd34e8049efeb": "länka peer annan dator vps agenter arbetar där överlämning parkopplingskod",
11647
"3d00c452287f50bd": "lägg till parkoppla backend värd kod ssh-konfiguration agent tunnel sparad t3 connect",
apps/web/src/i18n/translations/zh.json
+6
@@ -23,6 +23,7 @@
23
"ef9533bcc048f17b": "{organization} 的策略不允许使用 T3 Connect。",
24
"986b0873f913a840": "{organization} 的策略不允许使用 webhook 任务。",
25
"eebc538e25b09fe2": "{organization} 的策略不允许导入浏览器 Cookie。",
26
+ "7642a133db05f164": "{organization} 的策略不允许在其他设备上打开此机器的本地服务器。",
27
"39f6771b49f9b3b6": "使用默认值",
28
"45bb0e90e1c42046": "在你回来后",
29
"d8fa0a55446bbb0d": "缓存过期前(测试版)",
@@ -4202,6 +4203,7 @@
4203
"075398ac562d74b0": "断开智能体会话",
4204
"1d2025060ba3d1c3": "无法转发端口 {port}",
4205
"086ecbb6f4c2e959": "无法在浏览器中打开",
4206
+ "112173d046bfc910": "localhost:{port} 运行在另一台机器上,目前无法为它转发端口。",
4207
"51052c00ab1ac8cc": "无法打开预览",
4208
"0ccd37739f9cf2b6": "无法停止服务器",
4209
"a610a81c4061bb4c": "服务器",
@@ -8024,6 +8026,8 @@
8026
"9bfddd9a835be5de": "服务器",
8027
"43b545c01503eee4": "重试更新",
8028
"2f015e6d5459dce9": "更新到 {version}",
8029
+ "8ebba639f92932c3": "允许其他设备打开此机器的本地服务器:在设备上加载的浏览器标签页、“在此设备上打开”以及端口转发。关闭后:浏览器标签页从此机器串流。",
8030
+ "1c5266bf18d0ed24": "允许预览隧道",
8031
"a0e93cca71d0417e": "已授权的客户端",
8032
"03b9501ae07b5cf3": "启用网络访问?",
8033
"a09aff32ef3d89c7": "停用网络访问?",
@@ -11652,6 +11656,8 @@
11656
"b5cd79513a06e7c3": "离线时保留 webhook",
11657
"fadd0fcd7b9e1651": "webhook 自动化 离线 队列 邮箱 t3 connect",
11658
"9bebacdcfbde18d4": "移动 推送通知 实时活动 云 隧道",
11659
+ "a4e6dee662edc3cf": "预览隧道",
11660
+ "8ed7c2a2226f4663": "localhost 回环 端口转发 在此设备上打开 浏览器 标签页 串流 安全 port forwarding",
11661
"1c3e0ac06c8a1f1e": "连接 服务器 后端 本地 远程 访问 管理员 权限 范围 配对链接 二维码 已授权的客户端 客户端连接 撤销 端点",
11662
"744fd34e8049efeb": "关联 对等 另一台机器 vps 智能体 在那里工作 移交 配对码",
11663
"3d00c452287f50bd": "添加 配对 后端 主机 代码 ssh 配置 认证代理 隧道 已保存 t3 connect",
apps/web/src/state/portForwards.ts
+14
-4
@@ -1,5 +1,9 @@
1
import { useAtomValue } from "@effect/atom-react";
2
-import type { DesktopPortForward, EnvironmentId } from "@t3tools/contracts";
2
+import {
3
+ allowsPreviewTunnel,
4
+ type DesktopPortForward,
5
+ type EnvironmentId,
6
+} from "@t3tools/contracts";
7
import * as Effect from "effect/Effect";
8
import * as Option from "effect/Option";
9
import * as Queue from "effect/Queue";
@@ -49,9 +53,15 @@ export function usePortForwards(): ReadonlyArray<DesktopPortForward> {
53
return AsyncResult.getOrElse(useAtomValue(portForwardsAtom), () => EMPTY_FORWARDS);
54
}
55
52
-/** Only the desktop app forwards, and only from environments it reaches through the tunnel. */
53
-export const canForwardPorts = (target: ConnectionTarget | undefined): boolean =>
54
- previewBridge() !== undefined && tunnelsEnvironmentLoopback(target);
56
+/** Only the desktop app forwards, and only from environments whose tunnel it may use. */
57
+export const canForwardPorts = (environment: {
58
+ readonly entry: { readonly target: ConnectionTarget };
59
+ readonly serverConfig: Parameters<typeof allowsPreviewTunnel>[0] | null;
60
+}): boolean =>
61
+ previewBridge() !== undefined &&
62
+ tunnelsEnvironmentLoopback(environment.entry.target) &&
63
+ environment.serverConfig !== null &&
64
+ allowsPreviewTunnel(environment.serverConfig);
65
66
/**
67
* Whether the environment runs on another machine. A saved route can still lead back to this
docs/internals/remote.md
+3
@@ -181,6 +181,9 @@ undo by accident:
181
up in `/proc/net/tcp` and refuses other users. macOS and Windows have no such check yet. The
182
mobile app's device preview has the same listener while it is open: iOS suspends other apps, but
183
Android lets any app reach it, and apps cannot see another app's socket owner there.
184
+- **Off stays routed.** `allowsPreviewTunnel` (setting plus policy) gates the route and, from
185
+ server config, the clients, which then stream. The partition keeps its tunnel proxy anyway, so a
186
+ desktop tab left open fails instead of loading the reviewer's own localhost.
187
- **System browser links** have no tunnel. They keep the private-network rewrite in
188
[`browserTargetResolver.ts`](../../apps/web/src/browser/browserTargetResolver.ts).
189
docs/user/managed-policy.md
+5
@@ -169,6 +169,7 @@ A few settings need care:
169
"connect": false,
170
"webhookTasks": false,
171
"browserCookieImport": false,
172
+ "previewTunnel": false,
173
"telemetry": false,
174
"providers": {
175
"allowedDrivers": ["claudeAgent", "codex"],
@@ -250,6 +251,10 @@ so restart T3 Code after that.
251
but do not run, and cannot be turned back on. Users can still edit or delete them.
252
- `browserCookieImport: false`: users cannot import cookies from another browser into T3 Code's
253
browser.
254
+- `previewTunnel: false`: other devices cannot load this machine's `localhost` pages themselves.
255
+ Browser tabs stream from it instead, and port forwarding and **Open on this device** are
256
+ unavailable. This wins over the user's
257
+ [Preview tunnel setting](./remote-access.md#browser-on-a-remote-environment).
258
- `telemetry: false`: the server and desktop app send no [product usage data](./telemetry.md) or
259
relay connection traces. A policy cannot turn them on. A browser that opens the server, such as
260
app.t3.codes, still sends its own relay traces.
docs/user/remote-access.md
+8
@@ -330,6 +330,14 @@ and site data on the phone. On iPhone and iPad the page runs under a stand-in
330
address while the address bar shows `localhost`, so browser features that need
331
a secure page, such as the clipboard or service workers, aren't available there.
332
333
+All of this rides the host's preview tunnel. Turn off **Settings → Sharing &
334
+access → Preview tunnel** on the host to stop other devices from loading its
335
+`localhost` pages themselves: port forwarding and **Open on this device** go
336
+away, and open tunnels close. Tabs keep working by streaming from the host, so
337
+anyone who can use the host's browser tabs can still view its `localhost` pages
338
+there. An administrator can also turn it off with a
339
+[managed policy](./managed-policy.md#other-capabilities).
340
+
341
The first tab downloads a headless Chrome, about 120 MB, into the T3 home. It
342
is the same browser [HTML renders](html-renders.md) use, so a host downloads it
343
only once. Some Linux hosts need [setup](#browser-host-setup) before it can
packages/client-runtime/src/contractLabels.ts
+9
-1
@@ -129,7 +129,8 @@ export type ManagedCapability =
129
| "remoteClients"
130
| "connect"
131
| "webhookTasks"
132
- | "browserCookieImport";
132
+ | "browserCookieImport"
133
+ | "previewTunnel";
134
135
function managedCapabilityDeniedMessage(
136
organization: string,
@@ -155,6 +156,13 @@ function managedCapabilityDeniedMessage(
156
organization,
157
}),
158
);
159
+ case "previewTunnel":
160
+ return resolve(
161
+ msg(
162
+ "{organization}'s policy does not allow opening this machine's local servers on other devices.",
163
+ { organization },
164
+ ),
165
+ );
166
}
167
}
168
packages/contracts/src/environment.ts
+2
@@ -146,6 +146,8 @@ export const ExecutionEnvironmentCapabilities = Schema.Struct({
146
threadStop: Schema.optionalKey(Schema.Boolean),
147
/** Absent on older servers and on Windows hosts, which cannot stop a discovered server. */
148
localServerStop: Schema.optionalKey(Schema.Boolean),
149
+ /** Honors `enablePreviewTunnel`; hide the switch where absent, since the tunnel stays on there. */
150
+ previewTunnelSetting: Schema.optionalKey(Schema.Boolean),
151
threadPullRequests: Schema.optionalKey(Schema.Boolean),
152
threadPullRequestWatch: Schema.optionalKey(Schema.Boolean),
153
pullRequestStackActions: Schema.optionalKey(Schema.Boolean),
packages/contracts/src/managedPolicy.ts
+14
@@ -81,6 +81,8 @@ export const ManagedPolicyLimits = Schema.Struct({
81
/** Can only turn product analytics off, never force it on. */
82
telemetry: Schema.optionalKey(Schema.Boolean),
83
browserCookieImport: Schema.optionalKey(Schema.Boolean),
84
+ /** `false` turns the preview tunnel off: no client reaches this machine's loopback ports. */
85
+ previewTunnel: Schema.optionalKey(Schema.Boolean),
86
providers: Schema.optionalKey(ManagedProviderLimits),
87
updates: Schema.optionalKey(ManagedUpdatesPolicy),
88
});
@@ -95,6 +97,7 @@ export const ManagedPolicySummaryLimits = Schema.Struct({
97
webhookTasks: Schema.optionalKey(Schema.Boolean),
98
telemetry: Schema.optionalKey(Schema.Boolean),
99
browserCookieImport: Schema.optionalKey(Schema.Boolean),
100
+ previewTunnel: Schema.optionalKey(Schema.Boolean),
101
providers: Schema.optionalKey(
102
Schema.Struct({
103
/** Absent means every driver is allowed. */
@@ -209,6 +212,7 @@ const CAPABILITY_LABELS = {
212
connect: "T3 Connect",
213
webhookTasks: "webhook tasks",
214
browserCookieImport: "importing browser cookies",
215
+ previewTunnel: "opening this machine's local servers on other devices",
216
} as const;
217
218
/** Why a capability is unavailable on an environment with `summary`, or undefined when allowed. */
@@ -227,6 +231,16 @@ export function managedCapabilityDenial(
231
: undefined;
232
}
233
234
+/** Whether the preview tunnel serves: the setting is on and no policy switches it off. */
235
+export function allowsPreviewTunnel(config: {
236
+ readonly settings: { readonly enablePreviewTunnel: boolean };
237
+ readonly managedPolicy?: ManagedPolicySummary | undefined;
238
+}): boolean {
239
+ return (
240
+ config.settings.enablePreviewTunnel && config.managedPolicy?.limits?.previewTunnel !== false
241
+ );
242
+}
243
+
244
/** Whether the policy lets `driver` run; clients name it with their own provider label. */
245
export function isManagedDriverAllowed(
246
summary: ManagedPolicySummary | undefined,
packages/contracts/src/settings.ts
+4
-1
@@ -1396,6 +1396,8 @@ export const ServerSettings = Schema.Struct({
1396
),
1397
1398
enableAgentBrowserAccess: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
1399
+ /** Lets clients reach this machine's loopback ports over `/api/preview/tunnel`. */
1400
+ enablePreviewTunnel: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
1401
cloudSpeechCredentials: CloudSpeechCredentials.pipe(
1402
Schema.withDecodingDefault(Effect.succeed({ openai: "", xai: "", openrouter: "" })),
1403
),
@@ -1858,6 +1860,7 @@ export const ServerSettingsPatch = Schema.Struct({
1860
keepAwakeWhileAgentsWork: Schema.optionalKey(Schema.Boolean),
1861
requireConnectDeviceApproval: Schema.optionalKey(Schema.Boolean),
1862
enableAgentBrowserAccess: Schema.optionalKey(Schema.Boolean),
1863
+ enablePreviewTunnel: Schema.optionalKey(Schema.Boolean),
1864
cloudSpeechCredentials: Schema.optionalKey(
1865
Schema.Struct({
1866
openai: Schema.optionalKey(SettingsSecretValue),
@@ -2006,7 +2009,7 @@ export function requiredScopesForServerSettingsPatch(
2009
let changesAccess = false;
2010
for (const [key, value] of Object.entries(patch)) {
2011
if (value === undefined) continue;
2009
- if (key === "requireConnectDeviceApproval") {
2012
+ if (key === "requireConnectDeviceApproval" || key === "enablePreviewTunnel") {
2013
changesAccess = true;
2014
} else if (
2015
key === "providers" ||
packages/shared/src/managedPolicyFile.ts
+1
@@ -114,6 +114,7 @@ export const WINDOWS_POLICY_VALUES = {
114
WebhookTasks: { type: "boolean", path: ["limits", "webhookTasks"] },
115
Telemetry: { type: "boolean", path: ["limits", "telemetry"] },
116
BrowserCookieImport: { type: "boolean", path: ["limits", "browserCookieImport"] },
117
+ PreviewTunnel: { type: "boolean", path: ["limits", "previewTunnel"] },
118
ProviderInstances: { type: "json", path: ["limits", "providers", "instances"] },
119
UpdatesMode: { type: "string", path: ["limits", "updates", "mode"] },
120
UpdatesFeedUrl: { type: "string", path: ["limits", "updates", "feedUrl"] },