Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions README.ja.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
<h1 align="center">dots-tailscale</h1>

<p align="center"><a href="README.md">English</a> · <a href="README.ko.md">한국어</a> · <a href="README.zh-CN.md">简体中文</a> · 日本語</p>

Dots のクラウドコンピューターで、ユーザー権限の OpenSSH とともに Tailscale を実行します。インストールファイル、ノードの状態、SSH の ID 情報は `/workspace` に保存し、実行時のソケット、PID、ログは `/tmp` に作成し直します。

`/workspace` が環境の入れ替え後も保持される環境を対象としています。新しい環境では、その都度 start コマンドを実行する必要があります。このプロジェクトは独立したもので、OpenAI や Tailscale の公式ツールではありません。

## デモ

![Dots ターミナルでインストール状況と Tailscale バージョン 1.102.4 を確認する画面](docs/assets/dots-tailscale-ssh-verification.png)

Dots デスクトップのターミナルで撮影された、メンテナー提供のスクリーンショットです。既存のインストール状況とステータス、および Tailscale 1.102.4 のバージョンが表示されています。提供された画像をそのまま使用しており、新規インストールや VM の入れ替えを示すものではありません。

```bash
bash /workspace/.dots-tailscale/start.sh check
/workspace/.dots-tailscale/tailscale version
```

## クイックスタート

Linux x86_64、Git、Python 3、OpenSSH、およびローカルポート 22 をバインドする権限が必要です。依存関係と SSH の設定については、[使用ガイド](docs/usage.ja.md)を参照してください。

確認済みの Dots SSH 環境では GitHub への HTTPS 直接接続に失敗したため、clone コマンドでは Dots のプロキシを明示的に指定しています。診断方法と設定の適用範囲は、[ダウンロード接続とプロキシ設定](docs/usage.ja.md#download-proxy)を参照してください。

```bash
cd /workspace
HTTPS_PROXY=http://browser-proxy:8889 HTTP_PROXY=http://browser-proxy:8889 \
git clone --branch v0.3.1 --depth 1 https://github.com/abruption/dots-tailscale.git
cd dots-tailscale
bash tailscale-setup.sh check
bash tailscale-setup.sh install
bash /workspace/.dots-tailscale/start.sh login
```

初回ログインでは承認用 URL が表示されます。クライアントの公開鍵をインストール済み SSH の `authorized_keys` ファイルに追加し、接続する前にクラウドコンピューターの GUI ターミナルでホスト鍵のフィンガープリントを確認してください。環境が入れ替わった後は、`bash /workspace/.dots-tailscale/start.sh` で既存のインストールを起動します。スクリプトは自動起動を登録しません。

## v0.3.1: 診断とプライベート HTTP 接続

これらのヘルパーを使うには、[v0.3.1](https://github.com/abruption/dots-tailscale/releases/tag/v0.3.1) のソースファイル 4 つをすべてインストールしてください。

```bash
/workspace/.dots-tailscale/dots-ts doctor
/workspace/.dots-tailscale/dots-ts cli status
/workspace/.dots-tailscale/dots-ts proxy show
```

`doctor` は状態を変更せず、ローカルの診断情報を読み取ります。`cli` はインストール済みの Tailscale バイナリとソケットを選択します。任意で使える loopback SOCKS5/HTTP プロキシは既定で無効です。有効にするには、デーモンを再起動する手順を別途確認してください。設定、アクセス方針、検証範囲については、[使用ガイド](docs/usage.ja.md#development-helpers)と[プライベート HTTP API の利用例](docs/private-http-api.ja.md)を参照してください。これらのプロキシは ChatGPT コネクター、MCP クライアント、Dots ブラウザーには自動設定されません。

## 同梱内容

| パス | 用途 |
|---|---|
| `tailscale-setup.sh`, `shim.py` | Tailscale の確認・インストール・起動、ローカル OpenSSH の設定、Tailscale の明示的な認証 |
| `dots-ts`, `dots_proxy.py` | CLI、診断、およびプロセスごとの任意の外向きプロキシ設定 |
| `home-persistence-probe.py` | HOME と `/workspace` の継続性を示すマーカーを記録 |
| `tests/` | オフライン回帰テスト |

[英語の使用ガイド](docs/usage.md)、[韓国語の使用ガイド](docs/usage.ko.md)、[中国語(簡体字)の使用ガイド](docs/usage.zh-CN.md)、[日本語の使用ガイド](docs/usage.ja.md)、[MIT ライセンス](LICENSE)を参照してください。
16 changes: 8 additions & 8 deletions README.ko.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
<h1 align="center">dots-tailscale</h1>

<p align="center"><a href="README.md">English</a> · 한국어</p>
<p align="center"><a href="README.md">English</a> · 한국어 · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a></p>

Dots 클라우드 컴퓨터에서 사용자 권한으로 Tailscale과 OpenSSH를 실행합니다. 설치 파일·장치 state·SSH identity는 `/workspace`, 실행 socket·PID·로그는 `/tmp`에 둡니다.
Dots 클라우드 컴퓨터에서 일반 사용자 권한으로 Tailscale과 OpenSSH를 실행합니다. 설치 파일, Tailscale 상태, SSH 키는 `/workspace`에 보관하고 실행 중 필요한 소켓·PID·로그는 `/tmp`에 둡니다.

`/workspace`가 환경 교체 후 보존되는 환경을 대상으로 합니다. 새 환경에서는 start 명령을 실행해야 합니다. OpenAI 또는 Tailscale 공식 도구가 아닌 독립 프로젝트입니다.

## 데모

![Dots 터미널에서 설치 상태와 Tailscale 버전 1.102.4를 확인하는 스크린샷](docs/assets/dots-tailscale-ssh-verification.png)

관리자가 제공한 Dots 데스크톱 터미널의 스크린샷입니다. 기존 설치 파일과 상태, Tailscale 1.102.4 버전을 확인하는 장면입니다. 제공된 이미지를 그대로 사용했으며, 새로 설치하는 과정은 포함하지 않습니다.
관리자가 제공한 Dots 데스크톱 터미널 화면입니다. 기존 설치 파일과 상태, Tailscale 1.102.4 버전을 확인한 모습이며, 새로 설치하거나 VM을 교체하는 장면은 아닙니다.

```bash
bash /workspace/.dots-tailscale/start.sh check
Expand All @@ -33,7 +33,7 @@ bash tailscale-setup.sh install
bash /workspace/.dots-tailscale/start.sh login
```

최초 로그인 URL을 승인한 뒤 SSH 공개키를 설치 경로의 `authorized_keys`에 등록하세요. 호스트 키 지문은 클라우드 컴퓨터의 GUI 터미널에서 확인한 후 SSH로 접속합니다. 환경이 교체되면 `bash /workspace/.dots-tailscale/start.sh`로 기존 설치를 수동 기동하세요.
최초 로그인 URL을 승인한 뒤 SSH 공개키를 설치 경로의 `authorized_keys`에 등록하세요. 호스트 키 지문은 클라우드 컴퓨터의 GUI 터미널에서 확인한 후 SSH로 접속합니다. 환경이 교체되면 `bash /workspace/.dots-tailscale/start.sh`로 기존 설치를 직접 실행해야 합니다. 스크립트는 자동 시작을 등록하지 않습니다.

## v0.3.1: 진단과 비공개 HTTP 접속

Expand All @@ -47,13 +47,13 @@ bash /workspace/.dots-tailscale/start.sh login

`doctor`는 상태를 바꾸지 않고 로컬 진단 정보를 읽습니다. `cli`는 설치된 Tailscale 실행 파일과 소켓을 선택합니다. 선택 기능인 로컬 SOCKS5·HTTP 프록시는 기본적으로 꺼져 있으며, 활성화하려면 데몬 재시작을 별도로 검토해야 합니다. 설정과 접근 정책, 검증 범위는 [사용 가이드](docs/usage.ko.md#development-helpers)와 [비공개 HTTP API 연결 예시](docs/private-http-api.ko.md)를 참고하세요. ChatGPT 커넥터·MCP 클라이언트·Dots 브라우저에 자동으로 적용되지는 않습니다.

## 파일
## 구성 요소

| 경로 | 역할 |
|---|---|
| `tailscale-setup.sh`, `shim.py` | Tailscale·OpenSSH 점검, 설치, 기동 및 명시적 인증 |
| `tailscale-setup.sh`, `shim.py` | Tailscale을 점검·설치·기동하고 로컬 OpenSSH를 설정하며 Tailscale 인증을 명시적으로 수행 |
| `dots-ts`, `dots_proxy.py` | CLI·진단과 프로세스별 외부 연결 프록시 설정 |
| `home-persistence-probe.py` | HOME과 `/workspace` 식별자 관찰 |
| `home-persistence-probe.py` | HOME과 `/workspace` 지속성 마커를 기록하고 변화 확인 |
| `tests/` | 오프라인 회귀 테스트 |

[English guide](docs/usage.md) · [MIT License](LICENSE)
[English guide](docs/usage.md) · [한국어 사용 가이드](docs/usage.ko.md) · [简体中文使用指南](docs/usage.zh-CN.md) · [日本語の使い方](docs/usage.ja.md) · [MIT License](LICENSE)
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<h1 align="center">dots-tailscale</h1>

<p align="center">English · <a href="README.ko.md">한국어</a></p>
<p align="center">English · <a href="README.ko.md">한국어</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a></p>

Run Tailscale with user-level OpenSSH in a Dots cloud computer. Installation files, node state, and SSH identity live in `/workspace`; runtime sockets, PIDs, and logs are recreated in `/tmp`.

Expand All @@ -10,7 +10,7 @@ This setup targets environments that preserve `/workspace`. Processes still need

![Dots terminal screenshot showing installation checks and Tailscale version 1.102.4](docs/assets/dots-tailscale-ssh-verification.png)

A screenshot provided by the maintainer from the Dots desktop terminal. It shows existing installation checks and status, plus Tailscale version 1.102.4. The supplied image is used unchanged. No new installation is performed in this screenshot.
This screenshot, provided by the maintainer, shows the existing installation checks and status, plus Tailscale version 1.102.4, in the Dots desktop terminal. The image is used unchanged; it does not show a new installation or a VM replacement.

```bash
bash /workspace/.dots-tailscale/start.sh check
Expand Down Expand Up @@ -51,9 +51,9 @@ Install all four source files from [v0.3.1](https://github.com/abruption/dots-ta

| Path | Purpose |
|---|---|
| `tailscale-setup.sh`, `shim.py` | Check, install, start, and explicitly authenticate Tailscale with local SSH |
| `tailscale-setup.sh`, `shim.py` | Check, install, and start Tailscale; configure local OpenSSH; authenticate Tailscale explicitly |
| `dots-ts`, `dots_proxy.py` | CLI, diagnostics, and optional per-process outbound proxy configuration |
| `home-persistence-probe.py` | Record HOME and `/workspace` continuity markers |
| `tests/` | Offline regression tests |

See the [English usage guide](docs/usage.md), [Korean usage guide](docs/usage.ko.md), and [MIT License](LICENSE).
See the [English usage guide](docs/usage.md), [Korean usage guide](docs/usage.ko.md), [Simplified Chinese usage guide](docs/usage.zh-CN.md), [Japanese usage guide](docs/usage.ja.md), and [MIT License](LICENSE).
59 changes: 59 additions & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
<h1 align="center">dots-tailscale</h1>

<p align="center"><a href="README.md">English</a> · <a href="README.ko.md">한국어</a> · 简体中文 · <a href="README.ja.md">日本語</a></p>

在 Dots 云电脑上以普通用户权限运行 Tailscale 和 OpenSSH。安装文件、节点状态和 SSH 身份保存在 `/workspace`;运行时套接字、PID 和日志会在 `/tmp` 中重新创建。

本方案适用于会保留 `/workspace` 的环境。每次进入新环境后,仍需运行启动命令。本项目独立开发,并非 OpenAI 或 Tailscale 的官方工具。

## 演示

![Dots 终端中的安装检查以及 Tailscale 版本 1.102.4 截图](docs/assets/dots-tailscale-ssh-verification.png)

这是维护者提供的 Dots 桌面终端截图,显示了已有安装的检查结果和状态,以及 Tailscale 版本 1.102.4。截图使用了原始图片,并未展示新安装或 VM 替换。

```bash
bash /workspace/.dots-tailscale/start.sh check
/workspace/.dots-tailscale/tailscale version
```

## 快速开始

需要 Linux x86_64、Git、Python 3、OpenSSH,以及绑定本地 22 端口的权限。完整依赖和 SSH 设置请参阅[使用指南](docs/usage.zh-CN.md)。

克隆命令明确使用 Dots 代理,因为在经过测试的 Dots SSH 环境中,直接通过 HTTPS 连接 GitHub 失败了。有关诊断方法和这些设置的适用范围,请参阅[下载连接与代理设置](docs/usage.zh-CN.md#download-proxy)。

```bash
cd /workspace
HTTPS_PROXY=http://browser-proxy:8889 HTTP_PROXY=http://browser-proxy:8889 \
git clone --branch v0.3.1 --depth 1 https://github.com/abruption/dots-tailscale.git
cd dots-tailscale
bash tailscale-setup.sh check
bash tailscale-setup.sh install
bash /workspace/.dots-tailscale/start.sh login
```

首次登录时会显示一个授权链接。将客户端公钥添加到已安装 SSH 的 `authorized_keys` 文件中,并在连接前通过云电脑的 GUI 终端核对主机密钥指纹。环境替换后,使用 `bash /workspace/.dots-tailscale/start.sh` 启动现有安装。脚本不会注册自动启动项。

## v0.3.1:诊断与私有 HTTP 访问

要使用这些辅助工具,请从 [v0.3.1](https://github.com/abruption/dots-tailscale/releases/tag/v0.3.1) 一并安装全部四个源文件。

```bash
/workspace/.dots-tailscale/dots-ts doctor
/workspace/.dots-tailscale/dots-ts cli status
/workspace/.dots-tailscale/dots-ts proxy show
```

`doctor` 读取本地诊断信息,不会更改状态。`cli` 会选择已安装的 Tailscale 二进制文件和套接字。可选的回环 SOCKS5/HTTP 代理默认关闭;启用前需要单独审查并重启守护进程。配置、访问策略和验证范围请参阅[使用指南](docs/usage.zh-CN.md#development-helpers)和[私有 HTTP API 配置示例](docs/private-http-api.zh-CN.md)。这些代理不会自动配置 ChatGPT 连接器、MCP 客户端或 Dots 浏览器。

## 项目内容

| 路径 | 用途 |
|---|---|
| `tailscale-setup.sh`, `shim.py` | 检查、安装和启动 Tailscale;配置本地 OpenSSH;Tailscale 身份验证需明确执行 |
| `dots-ts`, `dots_proxy.py` | CLI、诊断,以及可选的按进程配置出站代理 |
| `home-persistence-probe.py` | 记录 HOME 和 `/workspace` 的连续性标记 |
| `tests/` | 离线回归测试 |

另请参阅[英文使用指南](docs/usage.md)、[韩文使用指南](docs/usage.ko.md)、[简体中文使用指南](docs/usage.zh-CN.md)、[日语使用指南](docs/usage.ja.md)和 [MIT 许可证](LICENSE)。
Loading
Loading