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
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ brew install aida0710/tap/sshc
Homebrewを使わない場合は、インストーラーとバイナリのバージョンを同じReleaseタグに固定してください。

```sh
SSHC_VERSION=v0.66.2 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
```

Windows PowerShell:
Expand Down
10 changes: 5 additions & 5 deletions docs/release-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ Homebrewのformulaはソースからビルドするため、GoとNode.js 22もHo
## インストールスクリプト(macOS / Linux / FreeBSD / OpenBSD)

```sh
SSHC_VERSION=v0.66.2 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
```

FreeBSDとOpenBSDでは、curlの代わりにベースシステムの`fetch -qo -`(FreeBSD)、`ftp -Vo -`(OpenBSD)でスクリプトを取得できます。スクリプトも、curlとwgetが無ければこれらで取得し、`sha256 -q`でSHA-256を確かめます。
Expand All @@ -40,7 +40,7 @@ URLと`SSHC_VERSION`には同じ導入対象のタグを指定します。`main`

`SSHC_VERSION`を指定しない場合は、タグを固定せずにReleaseワークフローの署名を確かめます。通常は`~/.local/bin`にインストールし、rootで実行した場合は`/usr/local/bin`を使用します。

手動でダウンロードしたCLIやAPKは、GitHub CLIで次のように検証できます。`<downloaded-file>`にはCLIまたはAPKの実ファイルを、`<tag>`には導入するタグ(例: `v0.66.2`)を指定します。
手動でダウンロードしたCLIやAPKは、GitHub CLIで次のように検証できます。`<downloaded-file>`にはCLIまたはAPKの実ファイルを、`<tag>`には導入するタグ(例: `v0.67.0`)を指定します。

```sh
gh attestation verify <downloaded-file> --repo aida0710/sshc \
Expand Down Expand Up @@ -109,8 +109,8 @@ GitHub CLIでattestationを検証できる場合は、exeと`checksums.txt`の
再現可能な導入では、スクリプトと成果物を同じタグへ固定します。

```powershell
$env:SSHC_VERSION = 'v0.66.2'
irm https://github.com/aida0710/sshc/releases/download/v0.66.2/install.ps1 | iex
$env:SSHC_VERSION = 'v0.67.0'
irm https://github.com/aida0710/sshc/releases/download/v0.67.0/install.ps1 | iex
```

手動で配置する場合は、[GitHub Releases](https://github.com/aida0710/sshc/releases)からx64では`sshc-windows-amd64.exe`、Arm64では`sshc-windows-arm64.exe`を取得し、`checksums.txt`と照合してから`sshc.exe`へ名前を変更します。
Expand Down
32 changes: 32 additions & 0 deletions docs/releases/v0.67.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# sshc v0.67.0

v0.67.0では、同期の設定を別のマシンへ渡せるようにしました。設定済みのマシンで設定をファイルかQRコードに書き出し、追加するマシンで暗号化キーを入力して取り込みます。

あわせて、Android版にカメラの権限を追加し、同期の設定画面の表示を1か所直しています。

## 同期の設定の書き出しと取り込み

- これまでは、マシンを追加するたびに、エンドポイント、バケット、アクセスキーID、シークレットアクセスキーを入力していました。**設定済みのマシンから設定を渡し、追加するマシンでは暗号化キーを入力するだけで設定できるようにしました。**
- 書き出すには、設定済みのマシンでSyncの[同期設定を管理]を開き、「設定を書き出す」の[書き出す]を選びます。入力するものはありません。QRコードが表示され、[ファイルに保存]で`sshc-sync-settings.json`として保存することもできます。
- 取り込むには、追加するマシンのSyncで「書き出した設定を取り込む」の[ファイルを選択]か[QRコードを読み取る]を選びます。暗号化キーと同期の方向を入力して[取り込む]を選ぶと、接続の確認から設定の保存までを続けて行います。
- 取り込んだ直後は、設定が保存されるだけで、受信はしません。受信は、これまでどおり[変更を確認]か自動同期で行います。
- 同期の方向は書き出す設定に含めません。追加するマシンごとに、送受信、受信のみ、送信のみから選びます。
- 入力した暗号化キーが違うときと、書き出したあとで保存先が空になっていたときは、何も保存せずに理由を表示します。
- 設定が長くてQRコードに入り切らないときは、QRコードを表示せず、ファイルだけで渡します。

## 書き出した設定の安全性

- 書き出したファイルとQRコードには、バケットの接続情報とS3の認証情報が、暗号化キーで暗号化された状態で入ります。暗号化キーそのものは入りません。
- ファイルやQRコードを取得した第三者は、暗号化キーの総当たりをオフラインで試せます。暗号化キーを自分で決めている場合は、書き出しの画面に注意を表示します。sshcが生成した暗号化キーの使用をおすすめします。
- 書き出したファイルは、追加するマシンへ渡したあとに削除してください。詳しくは[セキュリティ](https://aida0710.github.io/sshc/reference/security)を参照してください。

## Android

- **Android版にカメラの権限を追加しました。** [QRコードを読み取る]を最初に選んだときに、カメラの使用の許可を求めます。カメラを使うのはQRコードを読み取っている間だけで、映像は保存も送信もしません。
- カメラを許可しない場合も、ファイルからの取り込みは使用できます。

## 同期の設定画面

- 暗号化キーを自分で決めて設定を保存したあとも、[自分で決める]のチェックが付いたままでした。保存したあとはチェックを外すようにしました。

**変更履歴**: [v0.66.2...v0.67.0](https://github.com/aida0710/sshc/compare/v0.66.2...v0.67.0)
4 changes: 2 additions & 2 deletions install.sh
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
#!/bin/sh
# sshc の CLI を入れる。
#
# SSHC_VERSION=v0.66.2 sh -c \
# 'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
# SSHC_VERSION=v0.67.0 sh -c \
# 'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
#
# 配布物は UI を埋め込んだ単一の CLI バイナリである。
# インストール前の検証内容と変更内容は標準出力へ表示する:
Expand Down
14 changes: 7 additions & 7 deletions pages/en/guide/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ sshc is a terminal app for macOS, Linux, FreeBSD, OpenBSD, Windows, and Android.
brew install aida0710/tap/sshc
```

Without Homebrew, pin both the installer URL and the binary version to the same release. This example installs `v0.66.2`.
Without Homebrew, pin both the installer URL and the binary version to the same release. This example installs `v0.67.0`.

```sh
SSHC_VERSION=v0.66.2 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
```

After installation, `sshc update` delegates upgrades to Homebrew or to a receipt-aware installer. It shows the planned change and asks for confirmation. In non-interactive automation, review the plan and use `sshc update --yes`.
Expand All @@ -30,12 +30,12 @@ Binaries for FreeBSD and OpenBSD (amd64 and arm64) are published from v0.59.1. H

```sh
# FreeBSD
SSHC_VERSION=v0.66.2 sh -c \
'fetch -qo - https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'fetch -qo - https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'

# OpenBSD
SSHC_VERSION=v0.66.2 sh -c \
'ftp -Vo - https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'ftp -Vo - https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
```

`sshc update` works as for an `install.sh` installation on macOS and Linux. `sshc service install` is not supported; to keep the engine running after you log out, run `sshc engine` inside tmux or screen.
Expand Down
14 changes: 7 additions & 7 deletions pages/guide/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ sshcはmacOS、Linux、FreeBSD、OpenBSD、Windows、Androidで利用できる
brew install aida0710/tap/sshc
```

Homebrewを使わない場合は、インストーラーとバイナリのバージョンを同じReleaseタグに固定してください。次は`v0.66.2`を導入する例です。
Homebrewを使わない場合は、インストーラーとバイナリのバージョンを同じReleaseタグに固定してください。次は`v0.67.0`を導入する例です。

```sh
SSHC_VERSION=v0.66.2 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'curl -fsSL https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
```

導入後は`sshc update`で更新できます。Homebrewで入れた場合はHomebrewから、`install.sh`で入れた場合は同じ配布元から更新されます。スクリプトなどで確認を省略する場合は、`sshc update --yes`を指定してください。
Expand All @@ -30,12 +30,12 @@ FreeBSDとOpenBSD(amd64・arm64)向けのバイナリは、v0.59.1から配

```sh
# FreeBSD
SSHC_VERSION=v0.66.2 sh -c \
'fetch -qo - https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'fetch -qo - https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'

# OpenBSD
SSHC_VERSION=v0.66.2 sh -c \
'ftp -Vo - https://raw.githubusercontent.com/aida0710/sshc/v0.66.2/install.sh | sh'
SSHC_VERSION=v0.67.0 sh -c \
'ftp -Vo - https://raw.githubusercontent.com/aida0710/sshc/v0.67.0/install.sh | sh'
```

`sshc update`での更新はmacOS・Linuxの`install.sh`版と同じです。`sshc service install`には対応していません。ログインしたあとも動かし続けるには、tmuxやscreenの中で`sshc engine`を実行してください。
Expand Down
Loading