bletun

KO | EN

gitlite — search

#javascript #python #ai #go #android #deep-learning #docker #nodejs #java #windows #awesome #cli #pytorch #openai

(★ 59)

SSH into your Linux Machine (e.g. headless Raspberry Pi) from Bluetooth.

bletun 최신버젼 다운로드

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# BLETUN

Make a TCP connection from Bluetooth.

## Use Case

SSH into a Linux machine, which is headless (e.g. Raspberry Pi Zero 2 W) or has a bad network configuration, without using a Display Monitor.

## For Device

When you have network connection:

1. Run `make device` to build the binary for device.
2. Put the binary into `/usr/local/bin`.
3. See Service below to make it auto start upon boot.

## For Host

1. Run `make host`
2. Create a SSH config in `~/.ssh/config`:

```ssh_config
   Host nuc
   	ProxyCommand bletun
   ```

3. `ssh nuc` and wait patiently, it will discover the first available device.

```bash
   $ ssh nuc.bt
   bletun: Connecting to b9a8d941-c272-7415-7eb9-b510e6a4217e
   bletun: Testing MTU...
   bletun: MTU: 512
   bletun: Connected
   Welcome to Alpine!
   
   The Alpine Wiki contains a large amount of how-to guides and general
   information about administrating Alpine systems.
   See <https://wiki.alpinelinux.org/>.
   
   You can setup the system with the command: setup-alpine
   
   You may change this message by editing /etc/motd.
   
   root@nuc:~ →
   ```

**Note:** Only one SSH connection is allowed at a time, which is a characteristic of Bluetooth connections.
If you want multiple shells, use *tmux*.

## Prerequisites

Packages:

1. dbus
2. bluez

## Service

### Systemd

File: `/etc/systemd/system/bletun.service`:

```ini
[Unit]
Description=bletun

# On Ubuntu, it changed? first it's sshd, it's now ssh.
#Requires=sshd.service
#After=sshd.service

[Service]
ExecStart=/usr/local/bin/bletun
Restart=on-failure

[Install]
WantedBy=multi-user.target
```

Enable:

```bash
$ sudo systemctl daemon-reload
$ sudo systemctl enable bletun.service
```

### OpenRC

File: `/etc/init.d/bletun`:

```bash
/etc/init.d/bletun
#!/sbin/openrc-run

name="bletun"
command="/usr/local/bin/bletun"
pidfile="/run/bletun.pid"
command_background=true
supervisor=supervise-daemon
respawn_delay=5
respawn_max=0

depend() {
	need dbus bluetooth
}
```

Enable:

```bash
$ chmod +x /etc/init.d/bletun
$ rc-update add bletun default
$ service bletun restart
```

## Security

There's no Bluetooth Paring. Anyone can connect to the same device. Authentication is done by SSH.

## TODO

- [ ] Flow Control: Sending is too fast, while Recv is too slow.
- [ ] Allow more than one client.

bletun

bletun 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

bletun

bletun 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README