piping-ssh-web - GitLite

KO | EN

gitlite — search

#javascript #react #ai #typescript #go #machine-learning #rust #deep-learning #linux #awesome #kubernetes #awesome-list #pytorch #open-source

piping-ssh-web

(★ 132)

SSH over HTTPS via Piping Server on Web browser

파일 탐색기

최종 버전 다운로드 (.zip)

- - deploy.yml
- dependabot.yml
- - jsutil.go
- do_ssh.go
- go.mod
- go.sum
- golang-crypto
- golang-crypto.patch
- main.go
- make_patch.sh
- ssh_keygen.go
- transport_conn.go
- .gitignore
- index.html
- - CopyToClipboardButton.vue
  - KeyGenerator.vue
  - KeyManager.vue
  - KeysEditor.vue
  - PipingSsh.vue
- - en.ts
  - ja.ts
  - strings.ts
- App.vue
- authKeySets.ts
- createRequiredRules.ts
- fragment-params.ts
- getServerHostCommand.ts
- go-wasm-exported-promise.ts
- go-wasm-using-worker.ts
- go-wasm-worker.ts
- language.ts
- localStorageKeys.ts
- main.ts
- ServerHostKeyManager.ts
- sessionStorageKeys.ts
- shims-vue.d.ts
- supportsRequestStreamsPromise.ts
.browserslistrc
.gitignore
.gitmodules
babel.config.js
LICENSE
package-lock.json
package.json
README.md
tsconfig.json
vue.config.js

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/nwtgck/piping-ssh-web

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd piping-ssh-web

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

3. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

cd go

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# piping-ssh
SSH over HTTPS via [Piping Server] on browser.

<https://piping-ssh.nwtgck.org>

We often want to access applications on our remote machine. But some environments have NATs or difficulties with opening a port to the public and getting a static IP. There is a way to forward a port over HTTPS with high transparency. This project aims to provide an SSH client that works on the browser and is compatible with the highly transparent way.

<img src="https://github.com/nwtgck/piping-ssh-web/assets/10933561/4ca90e1b-75f4-43ac-8fd8-7ddd93d8a8bb" width="600" alt="SSH over pure HTTPS via Piping Server">

On the SSH server side, you can simply run the following command.
```bash
curl -sSN https://ppng.io/aaa | nc localhost 22 | curl -sSNT - https://ppng.io/bbb
```

The command above consists only of `curl` and `nc`, which are widely used and trusted. These commands are likely to already be installed on your machine.

## Security
* SSH things are processed only in the browser without any server.
* Go language (`golang.org/x/crypto/ssh`) and WebAssembly are used.
* The connection between the browser and the SSH server are end-to-end encrypted.
* The connection between the browser and [Piping Server] is also encrypted in transit with HTTPS.
* The running command on the SSH server side is highly transparent, so you can easily understand what they are doing.

## SSH key generation
You can generate SSH keys only in the browser without any server.
* RSA 2048 bits
* RSA 4096 bits
* Ed25519

<img src="https://github.com/nwtgck/piping-ssh-web/assets/10933561/2d4fb37b-8cf7-4a72-a3dc-a3f93af1010c" width="600" alt="SSH key generation in browser">

You can also manage keys generated by `ssh-keygen` command with or without a passphrase.

## URL fragment parameters
You can store the configuration in the URL. All the parameters are in the URL fragment so they are never sent to the web server.
<img src="https://github.com/nwtgck/piping-ssh-web/assets/10933561/3c7caa52-b643-4c12-a7d5-022b900f530d" width="600" alt="piping-ssh-web with URL fragment parameters">

e.g. <https://piping-ssh.nwtgck.org/#?user=myuser&password=mypass&s_port=22&cs_path=aaa&sc_path=bbb>

* `user`: SSH user name
* `password`: SSH user password
* `server`: Piping Server URL
* `cs_path`: Server-to-client path
* `sc_path`: Client-to-server path
* `auto_connect`: Connect automatically
* `s_port`: SSH Server port for command hint
* `headers`: HTTP headers to Piping Server
    - (e.g. `[["X-MyExtra1", "myvalue1"], ["Content-Type", "application/myapp"]]`)

## Requirement
This project requires Google Chrome 105 or higher for [fetch() upload streaming](https://www.chromestatus.com/feature/5274139738767360) feature.
You can also use Chromium-based browsers.

## Previous version using SSHy
This project used to highly based on [SSHy] before Go language and WebAssembly were used.  
SSHy version: <https://6453204af3b3fc3555e79371--piping-ssh.netlify.app>

## Acknowledgements
The idea of tunneling over [Piping Server] was proposed by [@Cryolite](https://github.com/Cryolite) in a Japanese post, <https://qiita.com/Cryolite/items/ed8fa237dd8eab54ef2f>. Thanks!

[Piping Server]: https://github.com/nwtgck/piping-server
[SSHy]: https://github.com/stuicey/SSHy

## Self-hosting Piping Server
It is easy to use Replit and fork <https://replit.com/@nwtgck/piping> to host Piping Server for free. You can see <https://github.com/nwtgck/piping-server/wiki/How-to-self-host-Piping-Server> to get other ways.

## References
* <https://dev.to/nwtgck/secure-tcp-tunnel-from-anywhere-with-curl-and-nc-for-single-connection-2k5i>
* <https://dev.to/nwtgck/the-power-of-pure-http-screen-share-real-time-messaging-ssh-and-vnc-5ghc>