# asche910/freewireless architecture

> Architecture diagram of the GitHub repository asche910/freewireless, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asche910/freewireless
- Repository: https://github.com/asche910/freewireless

## Overview

FreeWireless is a deployment tutorial, not an application source tree. Its documented workflow is to run a SoftEther VPN server on an external VPS, configure a virtual hub and user, generate an OpenVPN profile, then import that profile into a client on Windows, Android, or iOS. The README also describes using UDP ports such as 53 to carry the VPN connection through networks that restrict access. The repository contains only the tutorial and two client installers; runtime relationships below are documented rather than verified in source.

Main entry points: [`openvpn-install-2.4.7-I607-Win10.exe`](https://github.com/asche910/freewireless/blob/master/openvpn-install-2.4.7-I607-Win10.exe) (OpenVPN Windows installer), [`OpenVPN for Android_v0.7.8_apkpure.com.apk`](https://github.com/asche910/freewireless/blob/master/OpenVPN%20for%20Android_v0.7.8_apkpure.com.apk) (OpenVPN Android app), [`README.md`](https://github.com/asche910/freewireless/blob/master/README.md) (Deployment instructions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guide["Setup guide"]
  node_readme["Deployment instructions<br/>[README.md]"]
end

subgraph group_server["VPN server"]
  node_vps{{"External VPS"}}
  node_softether["SoftEther VPN server"]
  node_admin["SoftEther administration"]
  node_profile["OpenVPN profile"]
end

subgraph group_clients["VPN clients"]
  node_windows["OpenVPN Windows installer"]
  node_android["OpenVPN Android app"]
  node_ios["OpenVPN Connect"]
  node_device(("Client device"))
end

node_operator(("Operator"))
node_hotspot{{"Restricted hotspot"}}

node_operator -->|"follows"| node_readme
node_operator -->|"installs server"| node_vps
node_vps -->|"hosts"| node_softether
node_operator -->|"configures hub"| node_admin
node_admin -->|"generates"| node_profile
node_operator -->|"installs"| node_windows
node_operator -->|"installs"| node_android
node_operator -->|"obtains"| node_ios
node_profile -->|"imports into"| node_device
node_windows -->|"connects from"| node_device
node_android -->|"connects from"| node_device
node_ios -->|"connects from"| node_device
node_device -->|"VPN tunnel"| node_softether
node_device -->|"uses UDP"| node_hotspot

click node_readme "https://github.com/asche910/freewireless/blob/master/README.md"
click node_windows "https://github.com/asche910/freewireless/blob/master/openvpn-install-2.4.7-I607-Win10.exe"
click node_android "https://github.com/asche910/freewireless/blob/master/OpenVPN%20for%20Android_v0.7.8_apkpure.com.apk"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme toneBlue
class node_vps,node_softether,node_admin,node_profile toneAmber
class node_windows,node_android,node_ios,node_device toneMint
class node_operator,node_hotspot toneIndigo
```

## Components

### Setup guide

- [Deployment instructions](https://github.com/asche910/freewireless/blob/master/README.md): `README.md`

### VPN server

- **External VPS**
- **SoftEther VPN server**
- **SoftEther administration**
- **OpenVPN profile**

### VPN clients

- [OpenVPN Windows installer](https://github.com/asche910/freewireless/blob/master/openvpn-install-2.4.7-I607-Win10.exe): `openvpn-install-2.4.7-I607-Win10.exe`
- [OpenVPN Android app](https://github.com/asche910/freewireless/blob/master/OpenVPN%20for%20Android_v0.7.8_apkpure.com.apk): `OpenVPN for Android_v0.7.8_apkpure.com.apk`
- **OpenVPN Connect**
- **Client device**

### Other components

- **Operator**
- **Restricted hotspot**

## Connections

- Operator → Deployment instructions: follows (evidence: `README.md`)
- Operator → External VPS: installs server (evidence: `README.md`)
- External VPS → SoftEther VPN server: hosts (evidence: `README.md`)
- Operator → SoftEther administration: configures hub (evidence: `README.md`)
- SoftEther administration → OpenVPN profile: generates (evidence: `README.md`)
- Operator → OpenVPN Windows installer: installs (evidence: `README.md`)
- Operator → OpenVPN Android app: installs (evidence: `README.md`)
- Operator → OpenVPN Connect: obtains (evidence: `README.md`)
- OpenVPN profile → Client device: imports into (evidence: `README.md`)
- OpenVPN Windows installer → Client device: connects from (evidence: `README.md`)
- OpenVPN Android app → Client device: connects from (evidence: `README.md`)
- OpenVPN Connect → Client device: connects from (evidence: `README.md`)
- Client device → SoftEther VPN server: VPN tunnel (evidence: `README.md`)
- Client device → Restricted hotspot: uses UDP (evidence: `README.md`)
