plugmein.bat/README.md

42 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

2022-05-06 14:04:54 +00:00
# plugmein.bat
2022-05-06 14:59:29 +00:00
Instantly connect your (or someone else's) dumb **Windows** ass to the **Yggdrasil Network** on demand, with single `.bat` file, no brains required.
2022-05-06 14:10:13 +00:00
2022-05-06 14:52:30 +00:00
![run as adm](_launch.png)
2022-05-06 14:10:13 +00:00
## Requirements
- Windows 10 version 1903 (May 2019 Update) or higher
2022-05-06 14:52:30 +00:00
- Network connection
## Usage
2022-05-06 15:32:19 +00:00
- Download `plugmein.bat` [**here**](../../../raw/branch/master/plugmein.bat) or [**there**](plugmein.bat), whatever works, just make sure your overly smart browser has not changed the `.bat` to `.txt`
2022-05-06 14:52:30 +00:00
- Right-click it
- Run as administrator
- Congratulations!
2022-05-06 14:59:29 +00:00
- Your Yggdrasil network **address has been copied to the clipboard**, you can share it with someone, e.g. to get help through SSH/VNC/RDP
2022-05-06 14:52:30 +00:00
2022-05-06 15:46:33 +00:00
Client window looks like that, green text means that the connection was successful. Just **close this window to disconnect**.
2022-05-06 14:52:30 +00:00
![cmd windows](_cmd.png)
## How it works
To connect to Yggdrasil network, it uses [Popura](https://github.com/popura-network/Popura) - Yggdrasil network client fork which adds several features, including [autopeering](https://github.com/popura-network/Popura/wiki/Autopeering), which kinda makes this whole story zeroconf.
It also downloads and unpacks [Wintun](https://www.wintun.net/) - Wireguard TUN driver that Yggdrasil uses to create virtual network adapter.
2022-05-06 14:59:29 +00:00
Downloads handled through [bitsadmin](https://docs.microsoft.com/ru-ru/windows-server/administration/windows-commands/bitsadmin), unpacking is done by `tar` (which has been [added in the Insider Build 17063](https://docs.microsoft.com/en-us/virtualization/community/team-blog/2017/20171219-tar-and-curl-come-to-windows), in the same patch that added `curl`, which would help a lot, but those sons of bitches broke it a long time ago and aren't interested in fixing it).
2022-05-06 14:52:30 +00:00
2022-05-06 15:13:01 +00:00
## Tips for remote assistance of Windows machines
The first time setup for all of the following is not pretty at all and unfortunately will require some brains. I'm still on the lookout for simple one-click solutions.
SSH access is somewhat reliable since Windows 10, [here's how to enable a server](https://docs.microsoft.com/en-us/windows-server/administration/openssh/openssh_install_firstuse).
I had a good time using TigerVNC for Windows hosts and Linux clients. [Here's how to install Windows server](https://github.com/TigerVNC/tigervnc/wiki/Setup-TigerVNC-server-%28Windows%29). So far, I haven't needed "Firewall setup" step. At the time of writing, [here is a server .exe](http://tigervnc.bphinz.com/nightly/windows/tigervnc64-winvnc-1.12.80.exe).
2022-05-06 14:52:30 +00:00
## Uninstalling
2022-05-06 15:13:01 +00:00
Just delete `plugmein.bat` and `plugmein` folder which was created alongside the `.bat` when it was first launched.