1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/headscale_ynh.git synced 2024-09-03 19:25:53 +02:00

Auto-update README

This commit is contained in:
yunohost-bot 2023-06-11 10:28:35 +00:00
parent d9fe25bc05
commit e402758542
2 changed files with 98 additions and 46 deletions

View file

@ -16,15 +16,56 @@ If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/in
## Overview ## Overview
Some long and extensive description of what the app is and does, lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. 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 ### Features
- Ut enim ad minim veniam, quis nostrud exercitation ullamco ;
- Laboris nisi ut aliquip ex ea commodo consequat ; - Full "base" support of Tailscale's features
- Duis aute irure dolor in reprehenderit in voluptate ; - Configurable DNS
- Velit esse cillum dolore eu fugiat nulla pariatur ; - [Split DNS](https://tailscale.com/kb/1054/dns/#using-dns-settings-in-the-admin-console)
- Excepteur sint occaecat cupidatat non proident, sunt in culpa." - 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.*
**Shipped version:** 0.22.3~ynh1 **Shipped version:** 0.22.3~ynh1
@ -33,26 +74,11 @@ Some long and extensive description of what the app is and does, lorem ipsum dol
![Screenshot of Headscale](./doc/screenshots/example.jpg) ![Screenshot of Headscale](./doc/screenshots/example.jpg)
## Disclaimers / important information
* Any known limitations, constrains or stuff not working, such as (but not limited to):
* requiring a full dedicated domain ?
* architectures not supported ?
* not-working single-sign on or LDAP integration ?
* the app requires an important amount of RAM / disk / .. to install or to work properly
* etc...
* Other infos that people should be aware of, such as:
* any specific step to perform after installing (such as manually finishing the install, specific admin credentials, ...)
* how to configure / administrate the application if it ain't obvious
* upgrade process / specificities / things to be aware of ?
* security considerations ?
## Documentation and resources ## Documentation and resources
* Official app website: <https://tailscale.com/> * Official app website: <https://headscale.net/>
* Official user documentation: <https://tailscale.com/kb/> * Official user documentation: <https://tailscale.com/kb/>
* Official admin documentation: <https://github.com/juanfont/headscale/tree/main/docs> * Official admin documentation: <https://headscale.net/>
* Upstream app code repository: <https://github.com/juanfont/headscale> * Upstream app code repository: <https://github.com/juanfont/headscale>
* YunoHost documentation for this app: <https://yunohost.org/app_headscale> * YunoHost documentation for this app: <https://yunohost.org/app_headscale>
* Report a bug: <https://github.com/YunoHost-Apps/headscale_ynh/issues> * Report a bug: <https://github.com/YunoHost-Apps/headscale_ynh/issues>

View file

@ -16,15 +16,56 @@ Si vous navez pas YunoHost, regardez [ici](https://yunohost.org/#/install) po
## Vue densemble ## Vue densemble
Some long and extensive description of what the app is and does, lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. 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 ### Features
- Ut enim ad minim veniam, quis nostrud exercitation ullamco ;
- Laboris nisi ut aliquip ex ea commodo consequat ; - Full "base" support of Tailscale's features
- Duis aute irure dolor in reprehenderit in voluptate ; - Configurable DNS
- Velit esse cillum dolore eu fugiat nulla pariatur ; - [Split DNS](https://tailscale.com/kb/1054/dns/#using-dns-settings-in-the-admin-console)
- Excepteur sint occaecat cupidatat non proident, sunt in culpa." - 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.*
**Version incluse :** 0.22.3~ynh1 **Version incluse :** 0.22.3~ynh1
@ -33,26 +74,11 @@ Some long and extensive description of what the app is and does, lorem ipsum dol
![Capture décran de Headscale](./doc/screenshots/example.jpg) ![Capture décran de Headscale](./doc/screenshots/example.jpg)
## Avertissements / informations importantes
* Any known limitations, constrains or stuff not working, such as (but not limited to):
* requiring a full dedicated domain ?
* architectures not supported ?
* not-working single-sign on or LDAP integration ?
* the app requires an important amount of RAM / disk / .. to install or to work properly
* etc...
* Other infos that people should be aware of, such as:
* any specific step to perform after installing (such as manually finishing the install, specific admin credentials, ...)
* how to configure / administrate the application if it ain't obvious
* upgrade process / specificities / things to be aware of ?
* security considerations ?
## Documentations et ressources ## Documentations et ressources
* Site officiel de lapp : <https://tailscale.com/> * Site officiel de lapp : <https://headscale.net/>
* Documentation officielle utilisateur : <https://tailscale.com/kb/> * Documentation officielle utilisateur : <https://tailscale.com/kb/>
* Documentation officielle de ladmin : <https://github.com/juanfont/headscale/tree/main/docs> * Documentation officielle de ladmin : <https://headscale.net/>
* Dépôt de code officiel de lapp : <https://github.com/juanfont/headscale> * Dépôt de code officiel de lapp : <https://github.com/juanfont/headscale>
* Documentation YunoHost pour cette app : <https://yunohost.org/app_headscale> * Documentation YunoHost pour cette app : <https://yunohost.org/app_headscale>
* Signaler un bug : <https://github.com/YunoHost-Apps/headscale_ynh/issues> * Signaler un bug : <https://github.com/YunoHost-Apps/headscale_ynh/issues>