42 lines
2.6 KiB
Markdown
42 lines
2.6 KiB
Markdown
# plugmein.bat
|
|
|
|
Instantly connect your (or someone else's) dumb **Windows** ass to the **Yggdrasil Network** on demand, with single `.bat` file, no brains required.
|
|
|
|
![run as adm](_launch.png)
|
|
|
|
## Requirements
|
|
|
|
- Windows 10 version 1903 (May 2019 Update) or higher
|
|
- Network connection
|
|
|
|
## Usage
|
|
|
|
- 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`
|
|
- Right-click it
|
|
- Run as administrator
|
|
- Congratulations!
|
|
- 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
|
|
|
|
Client window looks like that, green text means that the connection was successful. Just **close this window to disconnect**.
|
|
|
|
![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.
|
|
|
|
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).
|
|
|
|
## 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).
|
|
|
|
## Uninstalling
|
|
|
|
Just delete `plugmein.bat` and `plugmein` folder which was created alongside the `.bat` when it was first launched. |