mirror of
https://github.com/YunoHost-Apps/headscale_ynh.git
synced 2024-09-03 19:25:53 +02:00
94 lines
4 KiB
Markdown
94 lines
4 KiB
Markdown
|
<!--
|
|||
|
|
N.B.: Questo README è stato automaticamente generato da <https://github.com/YunoHost/apps/tree/master/tools/readme_generator>
|
|||
|
|
NON DEVE essere modificato manualmente.
|
|||
|
|
-->
|
|||
|
|
|
|||
|
|
# Headscale per YunoHost
|
|||
|
|
|
|||
|
|
[](https://dash.yunohost.org/appci/app/headscale)  
|
|||
|
|
|
|||
|
|
[](https://install-app.yunohost.org/?app=headscale)
|
|||
|
|
|
|||
|
|
*[Leggi questo README in altre lingue.](./ALL_README.md)*
|
|||
|
|
|
|||
|
|
> *Questo pacchetto ti permette di installare Headscale su un server YunoHost in modo semplice e veloce.*
|
|||
|
|
> *Se non hai YunoHost, consulta [la guida](https://yunohost.org/install) per imparare a installarlo.*
|
|||
|
|
|
|||
|
|
## Panoramica
|
|||
|
|
|
|||
|
|
An open source, self-hosted implementation of the Tailscale control server.
|
|||
|
|
|
|||
|
|
### What is Tailscale
|
|||
|
|
|
|||
|
|
Tailscale is [a modern VPN](https://tailscale.com/) built on top of
|
|||
|
|
[Wireguard](https://www.wireguard.com/).
|
|||
|
|
It [works like an overlay network](https://tailscale.com/blog/how-tailscale-works/)
|
|||
|
|
between the computers of your networks - using
|
|||
|
|
[NAT traversal](https://tailscale.com/blog/how-nat-traversal-works/).
|
|||
|
|
|
|||
|
|
Everything in Tailscale is Open Source, except the GUI clients for proprietary OS
|
|||
|
|
(Windows and macOS/iOS), and the control server.
|
|||
|
|
|
|||
|
|
The control server works as an exchange point of Wireguard public keys for the
|
|||
|
|
nodes in the Tailscale network. It assigns the IP addresses of the clients,
|
|||
|
|
creates the boundaries between each user, enables sharing machines between users,
|
|||
|
|
and exposes the advertised routes of your nodes.
|
|||
|
|
|
|||
|
|
A [Tailscale network (tailnet)](https://tailscale.com/kb/1136/tailnet/) is private
|
|||
|
|
network which Tailscale assigns to a user in terms of private users or an
|
|||
|
|
organisation.
|
|||
|
|
|
|||
|
|
### Design goal
|
|||
|
|
|
|||
|
|
Headscale aims to implement a self-hosted, open source alternative to the Tailscale
|
|||
|
|
control server.
|
|||
|
|
Headscale's goal is to provide self-hosters and hobbyists with an open-source
|
|||
|
|
server they can use for their projects and labs.
|
|||
|
|
It implements a narrow scope, a single Tailnet, suitable for a personal use, or a small
|
|||
|
|
open-source organisation.
|
|||
|
|
|
|||
|
|
### Features
|
|||
|
|
|
|||
|
|
|
|||
|
|
- Full "base" support of Tailscale's features
|
|||
|
|
- Configurable DNS
|
|||
|
|
- [Split DNS](https://tailscale.com/kb/1054/dns/#using-dns-settings-in-the-admin-console)
|
|||
|
|
- Node registration
|
|||
|
|
- Single-Sign-On (via Open ID Connect)
|
|||
|
|
- Pre authenticated key
|
|||
|
|
- Taildrop (File Sharing)
|
|||
|
|
- [Access control lists](https://tailscale.com/kb/1018/acls/)
|
|||
|
|
- [MagicDNS](https://tailscale.com/kb/1081/magicdns)
|
|||
|
|
- Support for multiple IP ranges in the tailnet
|
|||
|
|
- Dual stack (IPv4 and IPv6)
|
|||
|
|
- Routing advertising (including exit nodes)
|
|||
|
|
- Ephemeral nodes
|
|||
|
|
- Embedded [DERP server](https://tailscale.com/blog/how-tailscale-works/#encrypted-tcp-relays-derp)
|
|||
|
|
|
|||
|
|
*from Headscale's README. See Links section below.*
|
|||
|
|
|
|||
|
|
|
|||
|
|
**Versione pubblicata:** 0.22.3~ynh1
|
|||
|
|
## Documentazione e risorse
|
|||
|
|
|
|||
|
|
- Sito web ufficiale dell’app: <https://headscale.net/>
|
|||
|
|
- Documentazione ufficiale per gli utenti: <https://tailscale.com/kb/>
|
|||
|
|
- Documentazione ufficiale per gli amministratori: <https://headscale.net/>
|
|||
|
|
- Repository upstream del codice dell’app: <https://github.com/juanfont/headscale>
|
|||
|
|
- Store di YunoHost: <https://apps.yunohost.org/app/headscale>
|
|||
|
|
- Segnala un problema: <https://github.com/YunoHost-Apps/headscale_ynh/issues>
|
|||
|
|
|
|||
|
|
## Informazioni per sviluppatori
|
|||
|
|
|
|||
|
|
Si prega di inviare la tua pull request alla [branch di `testing`](https://github.com/YunoHost-Apps/headscale_ynh/tree/testing).
|
|||
|
|
|
|||
|
|
Per provare la branch di `testing`, si prega di procedere in questo modo:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
sudo yunohost app install https://github.com/YunoHost-Apps/headscale_ynh/tree/testing --debug
|
|||
|
|
o
|
|||
|
|
sudo yunohost app upgrade headscale -u https://github.com/YunoHost-Apps/headscale_ynh/tree/testing --debug
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Maggiori informazioni riguardo il pacchetto di quest’app:** <https://yunohost.org/packaging_apps>
|