Document quick temporary SSH access
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-10-17 09:10:37 +02:00
parent 11971ae7a7
commit e01df5b988
2 changed files with 38 additions and 2 deletions

View File

@ -137,8 +137,9 @@ cc doctor # inspect prerequisites and sources
cc menu # optional numbered menu
```
For key-based shells, file transfer, and remote Config Central commands from
CachyOS, follow the [advanced remote access guide](docs/advanced-remote-access.md).
For a two-command temporary debugging shell, or for permanent key-based access
from CachyOS, follow the
[advanced remote access guide](docs/advanced-remote-access.md#quick-temporary-access).
`sync` refuses to run while the checkout has uncommitted or untracked files. It
does not reset the checkout. Commit your edits first, or remove files you did not

View File

@ -12,6 +12,41 @@ WinRM deployment, but it is unnecessary here: cross-platform WinRM requires
additional listener, authentication, and certificate decisions that OpenSSH
avoids.
## Quick temporary access
For a debugging session, paste this single command into Windows PowerShell:
```powershell
irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/tools/TemporarySsh.ps1' | iex
```
Approve the UAC prompt. The helper installs the Windows OpenSSH Server optional
component if necessary, starts it, and creates a temporary firewall rule limited
to Private networks and the local subnet. It then prints the exact second
command to run from CachyOS, for example:
```bash
ssh Alice@192.168.1.42
```
Sign in with the Windows account password. A Windows Hello PIN cannot
authenticate an SSH connection. If the helper reports that no Private network
is active, change the trusted LAN's Windows network profile to Private before
connecting; it deliberately leaves SSH unreachable on Public networks.
When debugging is finished, run this from Windows PowerShell, locally or through
the SSH shell:
```powershell
$env:CONFIG_CENTRAL_TEMP_SSH='disable'; irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/tools/TemporarySsh.ps1' | iex
```
The disable command removes the temporary rule and restores the service and
standard OpenSSH firewall rule to the state recorded on the first enable. It
leaves the optional OpenSSH component installed, so the next temporary session
starts quickly. Use the permanent key setup below once remote access becomes a
regular workflow.
## Network boundary
Use these instructions on a trusted private LAN. Do not forward TCP port 22 from