2014-04-14 14:26:48 +00:00
|
|
|
{ config, lib, pkgs, ... }:
|
2010-05-16 16:20:00 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
with builtins;
|
2014-04-14 14:26:48 +00:00
|
|
|
with lib;
|
2010-05-16 16:20:00 +00:00
|
|
|
|
|
|
|
let
|
2010-07-12 06:03:52 +00:00
|
|
|
cfg = config.services.tor;
|
2020-09-11 05:46:59 +00:00
|
|
|
stateDir = "/var/lib/tor";
|
|
|
|
runDir = "/run/tor";
|
|
|
|
descriptionGeneric = option: ''
|
|
|
|
See <link xlink:href="https://2019.www.torproject.org/docs/tor-manual.html.en#${option}">torrc manual</link>.
|
|
|
|
'';
|
|
|
|
bindsPrivilegedPort =
|
|
|
|
any (p0:
|
|
|
|
let p1 = if p0 ? "port" then p0.port else p0; in
|
|
|
|
if p1 == "auto" then false
|
|
|
|
else let p2 = if isInt p1 then p1 else toInt p1; in
|
|
|
|
p1 != null && 0 < p2 && p2 < 1024)
|
|
|
|
(flatten [
|
|
|
|
cfg.settings.ORPort
|
|
|
|
cfg.settings.DirPort
|
|
|
|
cfg.settings.DNSPort
|
|
|
|
cfg.settings.ExtORPort
|
|
|
|
cfg.settings.HTTPTunnelPort
|
|
|
|
cfg.settings.NATDPort
|
|
|
|
cfg.settings.SOCKSPort
|
|
|
|
cfg.settings.TransPort
|
2017-04-16 13:19:16 +00:00
|
|
|
]);
|
2020-09-11 05:46:59 +00:00
|
|
|
optionBool = optionName: mkOption {
|
|
|
|
type = with types; nullOr bool;
|
|
|
|
default = null;
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionInt = optionName: mkOption {
|
|
|
|
type = with types; nullOr int;
|
|
|
|
default = null;
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionString = optionName: mkOption {
|
|
|
|
type = with types; nullOr str;
|
|
|
|
default = null;
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionStrings = optionName: mkOption {
|
|
|
|
type = with types; listOf str;
|
2017-04-16 13:19:16 +00:00
|
|
|
default = [];
|
2020-09-11 05:46:59 +00:00
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionAddress = mkOption {
|
|
|
|
type = with types; nullOr str;
|
|
|
|
default = null;
|
|
|
|
example = "0.0.0.0";
|
|
|
|
description = ''
|
|
|
|
IPv4 or IPv6 (if between brackets) address.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
optionUnix = mkOption {
|
|
|
|
type = with types; nullOr path;
|
|
|
|
default = null;
|
|
|
|
description = ''
|
|
|
|
Unix domain socket path to use.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
optionPort = mkOption {
|
|
|
|
type = with types; nullOr (oneOf [port (enum ["auto"])]);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
optionPorts = optionName: mkOption {
|
|
|
|
type = with types; listOf port;
|
|
|
|
default = [];
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionIsolablePort = with types; oneOf [
|
|
|
|
port (enum ["auto"])
|
|
|
|
(submodule ({config, ...}: {
|
|
|
|
options = {
|
|
|
|
addr = optionAddress;
|
|
|
|
port = optionPort;
|
|
|
|
flags = optionFlags;
|
|
|
|
SessionGroup = mkOption { type = nullOr int; default = null; };
|
|
|
|
} // genAttrs isolateFlags (name: mkOption { type = types.bool; default = false; });
|
|
|
|
config = {
|
|
|
|
flags = filter (name: config.${name} == true) isolateFlags ++
|
|
|
|
optional (config.SessionGroup != null) "SessionGroup=${toString config.SessionGroup}";
|
|
|
|
};
|
|
|
|
}))
|
|
|
|
];
|
|
|
|
optionIsolablePorts = optionName: mkOption {
|
|
|
|
default = [];
|
|
|
|
type = with types; either optionIsolablePort (listOf optionIsolablePort);
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
isolateFlags = [
|
|
|
|
"IsolateClientAddr"
|
|
|
|
"IsolateClientProtocol"
|
|
|
|
"IsolateDestAddr"
|
|
|
|
"IsolateDestPort"
|
|
|
|
"IsolateSOCKSAuth"
|
|
|
|
"KeepAliveIsolateSOCKSAuth"
|
|
|
|
];
|
|
|
|
optionSOCKSPort = doConfig: let
|
|
|
|
flags = [
|
|
|
|
"CacheDNS" "CacheIPv4DNS" "CacheIPv6DNS" "GroupWritable" "IPv6Traffic"
|
|
|
|
"NoDNSRequest" "NoIPv4Traffic" "NoOnionTraffic" "OnionTrafficOnly"
|
|
|
|
"PreferIPv6" "PreferIPv6Automap" "PreferSOCKSNoAuth" "UseDNSCache"
|
|
|
|
"UseIPv4Cache" "UseIPv6Cache" "WorldWritable"
|
|
|
|
] ++ isolateFlags;
|
|
|
|
in with types; oneOf [
|
|
|
|
port (submodule ({config, ...}: {
|
|
|
|
options = {
|
|
|
|
unix = optionUnix;
|
|
|
|
addr = optionAddress;
|
|
|
|
port = optionPort;
|
|
|
|
flags = optionFlags;
|
|
|
|
SessionGroup = mkOption { type = nullOr int; default = null; };
|
|
|
|
} // genAttrs flags (name: mkOption { type = types.bool; default = false; });
|
|
|
|
config = mkIf doConfig { # Only add flags in SOCKSPort to avoid duplicates
|
|
|
|
flags = filter (name: config.${name} == true) flags ++
|
|
|
|
optional (config.SessionGroup != null) "SessionGroup=${toString config.SessionGroup}";
|
|
|
|
};
|
|
|
|
}))
|
2017-04-16 13:19:16 +00:00
|
|
|
];
|
2020-09-11 05:46:59 +00:00
|
|
|
optionFlags = mkOption {
|
|
|
|
type = with types; listOf str;
|
|
|
|
default = [];
|
|
|
|
};
|
|
|
|
optionORPort = optionName: mkOption {
|
|
|
|
default = [];
|
|
|
|
example = 443;
|
|
|
|
type = with types; oneOf [port (enum ["auto"]) (listOf (oneOf [
|
|
|
|
port
|
|
|
|
(enum ["auto"])
|
|
|
|
(submodule ({config, ...}:
|
|
|
|
let flags = [ "IPv4Only" "IPv6Only" "NoAdvertise" "NoListen" ];
|
|
|
|
in {
|
|
|
|
options = {
|
|
|
|
addr = optionAddress;
|
|
|
|
port = optionPort;
|
|
|
|
flags = optionFlags;
|
|
|
|
} // genAttrs flags (name: mkOption { type = types.bool; default = false; });
|
|
|
|
config = {
|
|
|
|
flags = filter (name: config.${name} == true) flags;
|
|
|
|
};
|
|
|
|
}))
|
|
|
|
]))];
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionBandwith = optionName: mkOption {
|
|
|
|
type = with types; nullOr (either int str);
|
|
|
|
default = null;
|
|
|
|
description = descriptionGeneric optionName;
|
|
|
|
};
|
|
|
|
optionPath = optionName: mkOption {
|
|
|
|
type = with types; nullOr path;
|
|
|
|
default = null;
|
|
|
|
description = descriptionGeneric optionName;
|
2017-04-16 13:19:16 +00:00
|
|
|
};
|
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
mkValueString = k: v:
|
|
|
|
if v == null then ""
|
|
|
|
else if isBool v then
|
|
|
|
(if v then "1" else "0")
|
|
|
|
else if v ? "unix" && v.unix != null then
|
|
|
|
"unix:"+v.unix +
|
|
|
|
optionalString (v ? "flags") (" " + concatStringsSep " " v.flags)
|
|
|
|
else if v ? "port" && v.port != null then
|
|
|
|
optionalString (v ? "addr" && v.addr != null) "${v.addr}:" +
|
|
|
|
toString v.port +
|
|
|
|
optionalString (v ? "flags") (" " + concatStringsSep " " v.flags)
|
|
|
|
else if k == "ServerTransportPlugin" then
|
|
|
|
optionalString (v.transports != []) "${concatStringsSep "," v.transports} exec ${v.exec}"
|
|
|
|
else if k == "HidServAuth" then
|
|
|
|
concatMapStringsSep "\n${k} " (settings: settings.onion + " " settings.auth) v
|
|
|
|
else generators.mkValueStringDefault {} v;
|
|
|
|
genTorrc = settings:
|
|
|
|
generators.toKeyValue {
|
|
|
|
listsAsDuplicateKeys = true;
|
|
|
|
mkKeyValue = k: generators.mkKeyValueDefault { mkValueString = mkValueString k; } " " k;
|
|
|
|
}
|
|
|
|
(lib.mapAttrs (k: v:
|
|
|
|
# Not necesssary, but prettier rendering
|
|
|
|
if elem k [ "AutomapHostsSuffixes" "DirPolicy" "ExitPolicy" "SocksPolicy" ]
|
|
|
|
&& v != []
|
|
|
|
then concatStringsSep "," v
|
|
|
|
else v)
|
|
|
|
(lib.filterAttrs (k: v: !(v == null || v == ""))
|
|
|
|
settings));
|
|
|
|
torrc = pkgs.writeText "torrc" (
|
|
|
|
genTorrc cfg.settings +
|
|
|
|
concatStrings (mapAttrsToList (name: onion:
|
|
|
|
"HiddenServiceDir ${onion.path}\n" +
|
|
|
|
genTorrc onion.settings) cfg.relay.onionServices)
|
|
|
|
);
|
2010-05-16 16:20:00 +00:00
|
|
|
in
|
|
|
|
{
|
2019-12-10 01:51:19 +00:00
|
|
|
imports = [
|
2020-09-11 05:46:59 +00:00
|
|
|
(mkRenamedOptionModule [ "services" "tor" "client" "dns" "automapHostsSuffixes" ] [ "services" "tor" "settings" "AutomapHostsSuffixes" ])
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "dns" "isolationOptions" ] "Use services.tor.settings.DNSPort instead.")
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "dns" "listenAddress" ] "Use services.tor.settings.DNSPort instead.")
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "privoxy" "enable" ] "Use services.privoxy.enable and services.privoxy.enableTor instead.")
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "socksIsolationOptions" ] "Use services.tor.settings.SOCKSPort instead.")
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "socksListenAddressFaster" ] "Use services.tor.settings.SOCKSPort instead.")
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "client" "socksPolicy" ] [ "services" "tor" "settings" "SocksPolicy" ])
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "transparentProxy" "isolationOptions" ] "Use services.tor.settings.TransPort instead.")
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "client" "transparentProxy" "listenAddress" ] "Use services.tor.settings.TransPort instead.")
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "controlPort" ] [ "services" "tor" "settings" "ControlPort" ])
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "extraConfig" ] "Plese use services.tor.settings instead.")
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "hiddenServices" ] [ "services" "tor" "relay" "onionServices" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "accountingMax" ] [ "services" "tor" "settings" "AccountingMax" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "accountingStart" ] [ "services" "tor" "settings" "AccountingStart" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "address" ] [ "services" "tor" "settings" "Address" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "bandwidthBurst" ] [ "services" "tor" "settings" "BandwidthBurst" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "bandwidthRate" ] [ "services" "tor" "settings" "BandwidthRate" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "bridgeTransports" ] [ "services" "tor" "settings" "ServerTransportPlugin" "transports" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "contactInfo" ] [ "services" "tor" "settings" "ContactInfo" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "exitPolicy" ] [ "services" "tor" "settings" "ExitPolicy" ])
|
2019-12-10 01:51:19 +00:00
|
|
|
(mkRemovedOptionModule [ "services" "tor" "relay" "isBridge" ] "Use services.tor.relay.role instead.")
|
|
|
|
(mkRemovedOptionModule [ "services" "tor" "relay" "isExit" ] "Use services.tor.relay.role instead.")
|
2020-09-11 05:46:59 +00:00
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "nickname" ] [ "services" "tor" "settings" "Nickname" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "port" ] [ "services" "tor" "settings" "ORPort" ])
|
|
|
|
(mkRenamedOptionModule [ "services" "tor" "relay" "portSpec" ] [ "services" "tor" "settings" "ORPort" ])
|
2019-12-10 01:51:19 +00:00
|
|
|
];
|
|
|
|
|
2010-05-16 16:20:00 +00:00
|
|
|
options = {
|
|
|
|
services.tor = {
|
2020-09-11 05:46:59 +00:00
|
|
|
enable = mkEnableOption ''Tor daemon.
|
|
|
|
By default, the daemon is run without
|
|
|
|
relay, exit, bridge or client connectivity'';
|
|
|
|
|
|
|
|
openFirewall = mkEnableOption "opening of the relay port(s) in the firewall";
|
2010-05-16 16:20:00 +00:00
|
|
|
|
2020-08-30 17:15:43 +00:00
|
|
|
package = mkOption {
|
|
|
|
type = types.package;
|
|
|
|
default = pkgs.tor;
|
|
|
|
defaultText = "pkgs.tor";
|
|
|
|
example = literalExample "pkgs.tor";
|
2020-09-11 05:46:59 +00:00
|
|
|
description = "Tor package to use.";
|
2020-08-30 17:15:43 +00:00
|
|
|
};
|
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
enableGeoIP = mkEnableOption ''use of GeoIP databases.
|
|
|
|
Disabling this will disable by-country statistics for bridges and relays
|
|
|
|
and some client and third-party software functionality'' // { default = true; };
|
2017-03-11 17:55:12 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
controlSocket.enable = mkEnableOption ''control socket,
|
|
|
|
created in <literal>${runDir}/control</literal>'';
|
2017-04-16 13:18:44 +00:00
|
|
|
|
2014-12-06 09:37:31 +00:00
|
|
|
client = {
|
2020-09-11 05:46:59 +00:00
|
|
|
enable = mkEnableOption ''the routing of application connections.
|
|
|
|
You might want to disable this if you plan running a dedicated Tor relay'';
|
2010-09-18 11:30:14 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
transparentProxy.enable = mkEnableOption "transparent proxy";
|
|
|
|
dns.enable = mkEnableOption "DNS resolver";
|
2013-01-14 05:37:13 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
socksListenAddress = mkOption {
|
|
|
|
type = optionSOCKSPort false;
|
|
|
|
default = {addr = "127.0.0.1"; port = 9050; IsolateDestAddr = true;};
|
|
|
|
example = {addr = "192.168.0.1"; port = 9090; IsolateDestAddr = true;};
|
2014-12-18 05:54:33 +00:00
|
|
|
description = ''
|
|
|
|
Bind to this address to listen for connections from
|
2020-09-11 05:46:59 +00:00
|
|
|
Socks-speaking applications.
|
2010-09-18 11:30:14 +00:00
|
|
|
'';
|
|
|
|
};
|
2014-12-18 06:19:57 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
onionServices = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceDir";
|
|
|
|
default = {};
|
|
|
|
example = {
|
|
|
|
"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" = {
|
|
|
|
clientAuthorizations = ["/run/keys/tor/alice.prv.x25519"];
|
|
|
|
};
|
2017-04-16 13:19:16 +00:00
|
|
|
};
|
2020-09-11 05:46:59 +00:00
|
|
|
type = types.attrsOf (types.submodule ({name, config, ...}: {
|
|
|
|
options.clientAuthorizations = mkOption {
|
|
|
|
description = ''
|
|
|
|
Clients' authorizations for a v3 onion service,
|
|
|
|
as a list of files containing each one private key, in the format:
|
|
|
|
<screen>descriptor:x25519:<base32-private-key></screen>
|
|
|
|
'' + descriptionGeneric "_client_authorization";
|
|
|
|
type = with types; listOf path;
|
|
|
|
default = [];
|
|
|
|
example = ["/run/keys/tor/alice.prv.x25519"];
|
|
|
|
};
|
|
|
|
}));
|
2017-04-16 13:19:16 +00:00
|
|
|
};
|
2010-07-12 06:03:52 +00:00
|
|
|
};
|
|
|
|
|
2011-09-14 18:20:50 +00:00
|
|
|
relay = {
|
2020-09-11 05:46:59 +00:00
|
|
|
enable = mkEnableOption ''relaying of Tor traffic for others.
|
2010-07-12 06:03:52 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
See <link xlink:href="https://www.torproject.org/docs/tor-doc-relay" />
|
|
|
|
for details.
|
2013-06-04 10:02:37 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
Setting this to true requires setting
|
|
|
|
<option>services.tor.relay.role</option>
|
|
|
|
and
|
|
|
|
<option>services.tor.settings.ORPort</option>
|
|
|
|
options'';
|
2010-07-12 06:03:52 +00:00
|
|
|
|
2017-03-01 00:00:00 +00:00
|
|
|
role = mkOption {
|
|
|
|
type = types.enum [ "exit" "relay" "bridge" "private-bridge" ];
|
2010-09-18 11:30:14 +00:00
|
|
|
description = ''
|
2017-03-01 00:00:00 +00:00
|
|
|
Your role in Tor network. There're several options:
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>exit</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
An exit relay. This allows Tor users to access regular
|
|
|
|
Internet services through your public IP.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<important><para>
|
|
|
|
Running an exit relay may expose you to abuse
|
|
|
|
complaints. See
|
2020-09-11 05:46:59 +00:00
|
|
|
<link xlink:href="https://www.torproject.org/faq.html.en#ExitPolicies"/>
|
2017-03-01 00:00:00 +00:00
|
|
|
for more info.
|
|
|
|
</para></important>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
You can specify which services Tor users may access via
|
2020-09-11 05:46:59 +00:00
|
|
|
your exit relay using <option>settings.ExitPolicy</option> option.
|
2017-03-01 00:00:00 +00:00
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>relay</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Regular relay. This allows Tor users to relay onion
|
|
|
|
traffic to other Tor nodes, but not to public
|
|
|
|
Internet.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<important><para>
|
|
|
|
Note that some misconfigured and/or disrespectful
|
|
|
|
towards privacy sites will block you even if your
|
|
|
|
relay is not an exit relay. That is, just being listed
|
|
|
|
in a public relay directory can have unwanted
|
|
|
|
consequences.
|
|
|
|
|
|
|
|
Which means you might not want to use
|
|
|
|
this role if you browse public Internet from the same
|
|
|
|
network as your relay, unless you want to write
|
|
|
|
e-mails to those sites (you should!).
|
|
|
|
</para></important>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
See
|
|
|
|
<link xlink:href="https://www.torproject.org/docs/tor-doc-relay.html.en" />
|
|
|
|
for more info.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>bridge</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Regular bridge. Works like a regular relay, but
|
|
|
|
doesn't list you in the public relay directory and
|
2019-04-30 03:56:47 +00:00
|
|
|
hides your Tor node behind obfs4proxy.
|
2017-03-01 00:00:00 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Using this option will make Tor advertise your bridge
|
|
|
|
to users through various mechanisms like
|
|
|
|
<link xlink:href="https://bridges.torproject.org/" />, though.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<important>
|
|
|
|
<para>
|
2018-06-12 22:15:45 +00:00
|
|
|
WARNING: THE FOLLOWING PARAGRAPH IS NOT LEGAL ADVICE.
|
2020-09-11 05:46:59 +00:00
|
|
|
Consult with your lawyer when in doubt.
|
2017-03-01 00:00:00 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
This role should be safe to use in most situations
|
|
|
|
(unless the act of forwarding traffic for others is
|
|
|
|
a punishable offence under your local laws, which
|
2020-09-11 05:46:59 +00:00
|
|
|
would be pretty insane as it would make ISP illegal).
|
2017-03-01 00:00:00 +00:00
|
|
|
</para>
|
|
|
|
</important>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
See <link xlink:href="https://www.torproject.org/docs/bridges.html.en" />
|
|
|
|
for more info.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term><literal>private-bridge</literal></term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
Private bridge. Works like regular bridge, but does
|
|
|
|
not advertise your node in any way.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Using this role means that you won't contribute to Tor
|
|
|
|
network in any way unless you advertise your node
|
|
|
|
yourself in some way.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Use this if you want to run a private bridge, for
|
2020-09-11 05:46:59 +00:00
|
|
|
example because you'll give out your bridge addr
|
2017-03-01 00:00:00 +00:00
|
|
|
manually to your friends.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Switching to this role after measurable time in
|
2017-03-01 00:00:00 +00:00
|
|
|
"bridge" role is pretty useless as some Tor users
|
|
|
|
would have learned about your node already. In the
|
|
|
|
latter case you can still change
|
|
|
|
<option>port</option> option.
|
2017-03-01 00:00:00 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
See <link xlink:href="https://www.torproject.org/docs/bridges.html.en" />
|
|
|
|
for more info.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
2010-09-18 11:30:14 +00:00
|
|
|
'';
|
|
|
|
};
|
2010-07-12 06:03:52 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
onionServices = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceDir";
|
|
|
|
default = {};
|
|
|
|
example = {
|
|
|
|
"example.org/www" = {
|
|
|
|
map = [ 80 ];
|
|
|
|
authorizedClients = [
|
|
|
|
"descriptor:x25519:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
|
|
|
|
];
|
|
|
|
};
|
|
|
|
};
|
|
|
|
type = types.attrsOf (types.submodule ({name, config, ...}: {
|
|
|
|
options.path = mkOption {
|
|
|
|
type = types.path;
|
|
|
|
description = ''
|
|
|
|
Path where to store the data files of the hidden service.
|
|
|
|
If the <option>secretKey</option> is null
|
|
|
|
this defaults to <literal>${stateDir}/onion/$onion</literal>,
|
|
|
|
otherwise to <literal>${runDir}/onion/$onion</literal>.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
options.secretKey = mkOption {
|
|
|
|
type = with types; nullOr path;
|
|
|
|
default = null;
|
|
|
|
example = "/run/keys/tor/onion/expyuzz4wqqyqhjn/hs_ed25519_secret_key";
|
|
|
|
description = ''
|
|
|
|
Secret key of the onion service.
|
|
|
|
If null, Tor reuses any preexisting secret key (in <option>path</option>)
|
|
|
|
or generates a new one.
|
|
|
|
The associated public key and hostname are deterministically regenerated
|
|
|
|
from this file if they do not exist.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
options.authorizeClient = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceAuthorizeClient";
|
|
|
|
default = null;
|
|
|
|
type = types.nullOr (types.submodule ({...}: {
|
|
|
|
options = {
|
|
|
|
authType = mkOption {
|
|
|
|
type = types.enum [ "basic" "stealth" ];
|
|
|
|
description = ''
|
|
|
|
Either <literal>"basic"</literal> for a general-purpose authorization protocol
|
|
|
|
or <literal>"stealth"</literal> for a less scalable protocol
|
|
|
|
that also hides service activity from unauthorized clients.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
clientNames = mkOption {
|
|
|
|
type = with types; nonEmptyListOf (strMatching "[A-Za-z0-9+-_]+");
|
|
|
|
description = ''
|
|
|
|
Only clients that are listed here are authorized to access the hidden service.
|
|
|
|
Generated authorization data can be found in <filename>${stateDir}/onion/$name/hostname</filename>.
|
|
|
|
Clients need to put this authorization data in their configuration file using
|
|
|
|
<xref linkend="opt-services.tor.settings.HidServAuth"/>.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
};
|
|
|
|
}));
|
|
|
|
};
|
|
|
|
options.authorizedClients = mkOption {
|
|
|
|
description = ''
|
|
|
|
Authorized clients for a v3 onion service,
|
|
|
|
as a list of public key, in the format:
|
|
|
|
<screen>descriptor:x25519:<base32-public-key></screen>
|
|
|
|
'' + descriptionGeneric "_client_authorization";
|
|
|
|
type = with types; listOf str;
|
|
|
|
default = [];
|
|
|
|
example = ["descriptor:x25519:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"];
|
|
|
|
};
|
|
|
|
options.map = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServicePort";
|
|
|
|
type = with types; listOf (oneOf [
|
|
|
|
port (submodule ({...}: {
|
|
|
|
options = {
|
|
|
|
port = optionPort;
|
|
|
|
target = mkOption {
|
|
|
|
default = null;
|
|
|
|
type = nullOr (submodule ({...}: {
|
|
|
|
options = {
|
|
|
|
unix = optionUnix;
|
|
|
|
addr = optionAddress;
|
|
|
|
port = optionPort;
|
|
|
|
};
|
|
|
|
}));
|
|
|
|
};
|
|
|
|
};
|
|
|
|
}))
|
|
|
|
]);
|
|
|
|
apply = map (v: if isInt v then {port=v; target=null;} else v);
|
|
|
|
};
|
|
|
|
options.version = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceVersion";
|
|
|
|
type = with types; nullOr (enum [2 3]);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
options.settings = mkOption {
|
|
|
|
description = ''
|
|
|
|
Settings of the onion service.
|
|
|
|
'' + descriptionGeneric "_hidden_service_options";
|
|
|
|
default = {};
|
|
|
|
type = types.submodule {
|
|
|
|
freeformType = with types;
|
|
|
|
(attrsOf (nullOr (oneOf [str int bool (listOf str)]))) // {
|
|
|
|
description = "settings option";
|
|
|
|
};
|
|
|
|
options.HiddenServiceAllowUnknownPorts = optionBool "HiddenServiceAllowUnknownPorts";
|
|
|
|
options.HiddenServiceDirGroupReadable = optionBool "HiddenServiceDirGroupReadable";
|
|
|
|
options.HiddenServiceExportCircuitID = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceExportCircuitID";
|
|
|
|
type = with types; nullOr (enum ["haproxy"]);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
options.HiddenServiceMaxStreams = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceMaxStreams";
|
|
|
|
type = with types; nullOr (ints.between 0 65535);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
options.HiddenServiceMaxStreamsCloseCircuit = optionBool "HiddenServiceMaxStreamsCloseCircuit";
|
|
|
|
options.HiddenServiceNumIntroductionPoints = mkOption {
|
|
|
|
description = descriptionGeneric "HiddenServiceNumIntroductionPoints";
|
|
|
|
type = with types; nullOr (ints.between 0 20);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
options.HiddenServiceSingleHopMode = optionBool "HiddenServiceSingleHopMode";
|
|
|
|
options.RendPostPeriod = optionString "RendPostPeriod";
|
|
|
|
};
|
|
|
|
};
|
|
|
|
config = {
|
|
|
|
path = mkDefault ((if config.secretKey == null then stateDir else runDir) + "/onion/${name}");
|
|
|
|
settings.HiddenServiceVersion = config.version;
|
|
|
|
settings.HiddenServiceAuthorizeClient =
|
|
|
|
if config.authorizeClient != null then
|
|
|
|
config.authorizeClient.authType + " " +
|
|
|
|
concatStringsSep "," config.authorizeClient.clientNames
|
|
|
|
else null;
|
|
|
|
settings.HiddenServicePort = map (p: mkValueString "" p.port + " " + mkValueString "" p.target) config.map;
|
|
|
|
};
|
|
|
|
}));
|
2010-09-18 11:30:14 +00:00
|
|
|
};
|
2010-07-12 06:03:52 +00:00
|
|
|
};
|
2017-08-11 21:59:52 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
settings = mkOption {
|
2017-03-01 00:00:00 +00:00
|
|
|
description = ''
|
2020-09-11 05:46:59 +00:00
|
|
|
See <link xlink:href="https://2019.www.torproject.org/docs/tor-manual.html.en">torrc manual</link>
|
|
|
|
for documentation.
|
2017-03-01 00:00:00 +00:00
|
|
|
'';
|
2017-08-11 21:59:52 +00:00
|
|
|
default = {};
|
2020-09-11 05:46:59 +00:00
|
|
|
type = types.submodule {
|
|
|
|
freeformType = with types;
|
|
|
|
(attrsOf (nullOr (oneOf [str int bool (listOf str)]))) // {
|
|
|
|
description = "settings option";
|
|
|
|
};
|
|
|
|
options.Address = optionString "Address";
|
|
|
|
options.AssumeReachable = optionBool "AssumeReachable";
|
|
|
|
options.AccountingMax = optionBandwith "AccountingMax";
|
|
|
|
options.AccountingStart = optionString "AccountingStart";
|
|
|
|
options.AuthDirHasIPv6Connectivity = optionBool "AuthDirHasIPv6Connectivity";
|
|
|
|
options.AuthDirListBadExits = optionBool "AuthDirListBadExits";
|
|
|
|
options.AuthDirPinKeys = optionBool "AuthDirPinKeys";
|
|
|
|
options.AuthDirSharedRandomness = optionBool "AuthDirSharedRandomness";
|
|
|
|
options.AuthDirTestEd25519LinkKeys = optionBool "AuthDirTestEd25519LinkKeys";
|
|
|
|
options.AuthoritativeDirectory = optionBool "AuthoritativeDirectory";
|
|
|
|
options.AutomapHostsOnResolve = optionBool "AutomapHostsOnResolve";
|
|
|
|
options.AutomapHostsSuffixes = optionStrings "AutomapHostsSuffixes" // {
|
|
|
|
default = [".onion" ".exit"];
|
|
|
|
example = [".onion"];
|
2017-08-11 21:59:52 +00:00
|
|
|
};
|
2020-09-11 05:46:59 +00:00
|
|
|
options.BandwidthBurst = optionBandwith "BandwidthBurst";
|
|
|
|
options.BandwidthRate = optionBandwith "BandwidthRate";
|
|
|
|
options.BridgeAuthoritativeDir = optionBool "BridgeAuthoritativeDir";
|
|
|
|
options.BridgeRecordUsageByCountry = optionBool "BridgeRecordUsageByCountry";
|
|
|
|
options.BridgeRelay = optionBool "BridgeRelay" // { default = false; };
|
|
|
|
options.CacheDirectory = optionPath "CacheDirectory";
|
|
|
|
options.CacheDirectoryGroupReadable = optionBool "CacheDirectoryGroupReadable"; # default is null and like "auto"
|
|
|
|
options.CellStatistics = optionBool "CellStatistics";
|
|
|
|
options.ClientAutoIPv6ORPort = optionBool "ClientAutoIPv6ORPort";
|
|
|
|
options.ClientDNSRejectInternalAddresses = optionBool "ClientDNSRejectInternalAddresses";
|
|
|
|
options.ClientOnionAuthDir = mkOption {
|
|
|
|
description = descriptionGeneric "ClientOnionAuthDir";
|
|
|
|
default = null;
|
|
|
|
type = with types; nullOr path;
|
|
|
|
};
|
|
|
|
options.ClientPreferIPv6DirPort = optionBool "ClientPreferIPv6DirPort"; # default is null and like "auto"
|
|
|
|
options.ClientPreferIPv6ORPort = optionBool "ClientPreferIPv6ORPort"; # default is null and like "auto"
|
|
|
|
options.ClientRejectInternalAddresses = optionBool "ClientRejectInternalAddresses";
|
|
|
|
options.ClientUseIPv4 = optionBool "ClientUseIPv4";
|
|
|
|
options.ClientUseIPv6 = optionBool "ClientUseIPv6";
|
|
|
|
options.ConnDirectionStatistics = optionBool "ConnDirectionStatistics";
|
|
|
|
options.ConstrainedSockets = optionBool "ConstrainedSockets";
|
|
|
|
options.ContactInfo = optionString "ContactInfo";
|
|
|
|
options.ControlPort = mkOption rec {
|
|
|
|
description = descriptionGeneric "ControlPort";
|
|
|
|
default = [];
|
|
|
|
example = [{port = 9051;}];
|
|
|
|
type = with types; oneOf [port (enum ["auto"]) (listOf (oneOf [
|
|
|
|
port (enum ["auto"]) (submodule ({config, ...}: let
|
|
|
|
flags = ["GroupWritable" "RelaxDirModeCheck" "WorldWritable"];
|
|
|
|
in {
|
|
|
|
options = {
|
|
|
|
unix = optionUnix;
|
|
|
|
flags = optionFlags;
|
|
|
|
addr = optionAddress;
|
|
|
|
port = optionPort;
|
|
|
|
} // genAttrs flags (name: mkOption { type = types.bool; default = false; });
|
|
|
|
config = {
|
|
|
|
flags = filter (name: config.${name} == true) flags;
|
|
|
|
};
|
|
|
|
}))
|
|
|
|
]))];
|
|
|
|
};
|
|
|
|
options.ControlPortFileGroupReadable= optionBool "ControlPortFileGroupReadable";
|
|
|
|
options.ControlPortWriteToFile = optionPath "ControlPortWriteToFile";
|
|
|
|
options.ControlSocket = optionPath "ControlSocket";
|
|
|
|
options.ControlSocketsGroupWritable = optionBool "ControlSocketsGroupWritable";
|
|
|
|
options.CookieAuthFile = optionPath "CookieAuthFile";
|
|
|
|
options.CookieAuthFileGroupReadable = optionBool "CookieAuthFileGroupReadable";
|
|
|
|
options.CookieAuthentication = optionBool "CookieAuthentication";
|
|
|
|
options.DataDirectory = optionPath "DataDirectory" // { default = stateDir; };
|
|
|
|
options.DataDirectoryGroupReadable = optionBool "DataDirectoryGroupReadable";
|
|
|
|
options.DirPortFrontPage = optionPath "DirPortFrontPage";
|
|
|
|
options.DirAllowPrivateAddresses = optionBool "DirAllowPrivateAddresses";
|
|
|
|
options.DormantCanceledByStartup = optionBool "DormantCanceledByStartup";
|
|
|
|
options.DormantOnFirstStartup = optionBool "DormantOnFirstStartup";
|
|
|
|
options.DormantTimeoutDisabledByIdleStreams = optionBool "DormantTimeoutDisabledByIdleStreams";
|
|
|
|
options.DirCache = optionBool "DirCache";
|
|
|
|
options.DirPolicy = mkOption {
|
|
|
|
description = descriptionGeneric "DirPolicy";
|
|
|
|
type = with types; listOf str;
|
|
|
|
default = [];
|
|
|
|
example = ["accept *:*"];
|
|
|
|
};
|
|
|
|
options.DirPort = optionORPort "DirPort";
|
|
|
|
options.DirReqStatistics = optionBool "DirReqStatistics";
|
|
|
|
options.DisableAllSwap = optionBool "DisableAllSwap";
|
|
|
|
options.DisableDebuggerAttachment = optionBool "DisableDebuggerAttachment";
|
|
|
|
options.DisableNetwork = optionBool "DisableNetwork";
|
|
|
|
options.DisableOOSCheck = optionBool "DisableOOSCheck";
|
|
|
|
options.DNSPort = optionIsolablePorts "DNSPort";
|
|
|
|
options.DoSCircuitCreationEnabled = optionBool "DoSCircuitCreationEnabled";
|
|
|
|
options.DoSConnectionEnabled = optionBool "DoSConnectionEnabled"; # default is null and like "auto"
|
|
|
|
options.DoSRefuseSingleHopClientRendezvous = optionBool "DoSRefuseSingleHopClientRendezvous";
|
|
|
|
options.DownloadExtraInfo = optionBool "DownloadExtraInfo";
|
|
|
|
options.EnforceDistinctSubnets = optionBool "EnforceDistinctSubnets";
|
|
|
|
options.EntryStatistics = optionBool "EntryStatistics";
|
|
|
|
options.ExitPolicy = optionStrings "ExitPolicy" // {
|
|
|
|
default = ["reject *:*"];
|
|
|
|
example = ["accept *:*"];
|
|
|
|
};
|
|
|
|
options.ExitPolicyRejectLocalInterfaces = optionBool "ExitPolicyRejectLocalInterfaces";
|
|
|
|
options.ExitPolicyRejectPrivate = optionBool "ExitPolicyRejectPrivate";
|
|
|
|
options.ExitPortStatistics = optionBool "ExitPortStatistics";
|
|
|
|
options.ExitRelay = optionBool "ExitRelay"; # default is null and like "auto"
|
|
|
|
options.ExtORPort = mkOption {
|
|
|
|
description = descriptionGeneric "ExtORPort";
|
|
|
|
default = null;
|
|
|
|
type = with types; nullOr (oneOf [
|
|
|
|
port (enum ["auto"]) (submodule ({...}: {
|
|
|
|
options = {
|
|
|
|
addr = optionAddress;
|
|
|
|
port = optionPort;
|
|
|
|
};
|
|
|
|
}))
|
|
|
|
]);
|
|
|
|
apply = p: if isInt p || isString p then { port = p; } else p;
|
2017-03-01 00:00:00 +00:00
|
|
|
};
|
2020-09-11 05:46:59 +00:00
|
|
|
options.ExtORPortCookieAuthFile = optionPath "ExtORPortCookieAuthFile";
|
|
|
|
options.ExtORPortCookieAuthFileGroupReadable = optionBool "ExtORPortCookieAuthFileGroupReadable";
|
|
|
|
options.ExtendAllowPrivateAddresses = optionBool "ExtendAllowPrivateAddresses";
|
|
|
|
options.ExtraInfoStatistics = optionBool "ExtraInfoStatistics";
|
|
|
|
options.FascistFirewall = optionBool "FascistFirewall";
|
|
|
|
options.FetchDirInfoEarly = optionBool "FetchDirInfoEarly";
|
|
|
|
options.FetchDirInfoExtraEarly = optionBool "FetchDirInfoExtraEarly";
|
|
|
|
options.FetchHidServDescriptors = optionBool "FetchHidServDescriptors";
|
|
|
|
options.FetchServerDescriptors = optionBool "FetchServerDescriptors";
|
|
|
|
options.FetchUselessDescriptors = optionBool "FetchUselessDescriptors";
|
|
|
|
options.ReachableAddresses = optionStrings "ReachableAddresses";
|
|
|
|
options.ReachableDirAddresses = optionStrings "ReachableDirAddresses";
|
|
|
|
options.ReachableORAddresses = optionStrings "ReachableORAddresses";
|
|
|
|
options.GeoIPFile = optionPath "GeoIPFile";
|
|
|
|
options.GeoIPv6File = optionPath "GeoIPv6File";
|
|
|
|
options.GuardfractionFile = optionPath "GuardfractionFile";
|
|
|
|
options.HidServAuth = mkOption {
|
|
|
|
description = descriptionGeneric "HidServAuth";
|
|
|
|
default = [];
|
|
|
|
type = with types; listOf (oneOf [
|
|
|
|
(submodule {
|
|
|
|
options = {
|
|
|
|
onion = mkOption {
|
|
|
|
type = strMatching "[a-z2-7]{16}(\\.onion)?";
|
|
|
|
description = "Onion address.";
|
|
|
|
example = "xxxxxxxxxxxxxxxx.onion";
|
|
|
|
};
|
|
|
|
auth = mkOption {
|
|
|
|
type = strMatching "[A-Za-z0-9+/]{22}";
|
|
|
|
description = "Authentication cookie.";
|
|
|
|
};
|
|
|
|
};
|
|
|
|
})
|
|
|
|
]);
|
|
|
|
};
|
|
|
|
options.HiddenServiceNonAnonymousMode = optionBool "HiddenServiceNonAnonymousMode";
|
|
|
|
options.HiddenServiceStatistics = optionBool "HiddenServiceStatistics";
|
|
|
|
options.HSLayer2Nodes = optionStrings "HSLayer2Nodes";
|
|
|
|
options.HSLayer3Nodes = optionStrings "HSLayer3Nodes";
|
|
|
|
options.HTTPTunnelPort = optionIsolablePorts "HTTPTunnelPort";
|
|
|
|
options.IPv6Exit = optionBool "IPv6Exit";
|
|
|
|
options.KeyDirectory = optionPath "KeyDirectory";
|
|
|
|
options.KeyDirectoryGroupReadable = optionBool "KeyDirectoryGroupReadable";
|
|
|
|
options.LogMessageDomains = optionBool "LogMessageDomains";
|
|
|
|
options.LongLivedPorts = optionPorts "LongLivedPorts";
|
|
|
|
options.MainloopStats = optionBool "MainloopStats";
|
|
|
|
options.MaxAdvertisedBandwidth = optionBandwith "MaxAdvertisedBandwidth";
|
|
|
|
options.MaxCircuitDirtiness = optionInt "MaxCircuitDirtiness";
|
|
|
|
options.MaxClientCircuitsPending = optionInt "MaxClientCircuitsPending";
|
|
|
|
options.NATDPort = optionIsolablePorts "NATDPort";
|
|
|
|
options.NewCircuitPeriod = optionInt "NewCircuitPeriod";
|
|
|
|
options.Nickname = optionString "Nickname";
|
|
|
|
options.ORPort = optionORPort "ORPort";
|
|
|
|
options.OfflineMasterKey = optionBool "OfflineMasterKey";
|
|
|
|
options.OptimisticData = optionBool "OptimisticData"; # default is null and like "auto"
|
|
|
|
options.PaddingStatistics = optionBool "PaddingStatistics";
|
|
|
|
options.PerConnBWBurst = optionBandwith "PerConnBWBurst";
|
|
|
|
options.PerConnBWRate = optionBandwith "PerConnBWRate";
|
|
|
|
options.PidFile = optionPath "PidFile";
|
|
|
|
options.ProtocolWarnings = optionBool "ProtocolWarnings";
|
|
|
|
options.PublishHidServDescriptors = optionBool "PublishHidServDescriptors";
|
|
|
|
options.PublishServerDescriptor = mkOption {
|
|
|
|
description = descriptionGeneric "PublishServerDescriptor";
|
|
|
|
type = with types; nullOr (enum [false true 0 1 "0" "1" "v3" "bridge"]);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
options.ReducedExitPolicy = optionBool "ReducedExitPolicy";
|
|
|
|
options.RefuseUnknownExits = optionBool "RefuseUnknownExits"; # default is null and like "auto"
|
|
|
|
options.RejectPlaintextPorts = optionPorts "RejectPlaintextPorts";
|
|
|
|
options.RelayBandwidthBurst = optionBandwith "RelayBandwidthBurst";
|
|
|
|
options.RelayBandwidthRate = optionBandwith "RelayBandwidthRate";
|
|
|
|
#options.RunAsDaemon
|
|
|
|
options.Sandbox = optionBool "Sandbox";
|
|
|
|
options.ServerDNSAllowBrokenConfig = optionBool "ServerDNSAllowBrokenConfig";
|
|
|
|
options.ServerDNSAllowNonRFC953Hostnames = optionBool "ServerDNSAllowNonRFC953Hostnames";
|
|
|
|
options.ServerDNSDetectHijacking = optionBool "ServerDNSDetectHijacking";
|
|
|
|
options.ServerDNSRandomizeCase = optionBool "ServerDNSRandomizeCase";
|
|
|
|
options.ServerDNSResolvConfFile = optionPath "ServerDNSResolvConfFile";
|
|
|
|
options.ServerDNSSearchDomains = optionBool "ServerDNSSearchDomains";
|
|
|
|
options.ServerTransportPlugin = mkOption {
|
|
|
|
description = descriptionGeneric "ServerTransportPlugin";
|
|
|
|
default = null;
|
|
|
|
type = with types; nullOr (submodule ({...}: {
|
|
|
|
options = {
|
|
|
|
transports = mkOption {
|
|
|
|
description = "List of pluggable transports.";
|
|
|
|
type = listOf str;
|
|
|
|
example = ["obfs2" "obfs3" "obfs4" "scramblesuit"];
|
|
|
|
};
|
|
|
|
exec = mkOption {
|
|
|
|
type = types.str;
|
|
|
|
description = "Command of pluggable transport.";
|
|
|
|
};
|
|
|
|
};
|
|
|
|
}));
|
|
|
|
};
|
|
|
|
options.SocksPolicy = optionStrings "SocksPolicy" // {
|
|
|
|
example = ["accept *:*"];
|
|
|
|
};
|
|
|
|
options.SOCKSPort = mkOption {
|
|
|
|
description = descriptionGeneric "SOCKSPort";
|
|
|
|
default = if cfg.settings.HiddenServiceNonAnonymousMode == true then [{port = 0;}] else [];
|
|
|
|
example = [{port = 9090;}];
|
|
|
|
type = types.listOf (optionSOCKSPort true);
|
|
|
|
};
|
|
|
|
options.TestingTorNetwork = optionBool "TestingTorNetwork";
|
|
|
|
options.TransPort = optionIsolablePorts "TransPort";
|
|
|
|
options.TransProxyType = mkOption {
|
|
|
|
description = descriptionGeneric "TransProxyType";
|
|
|
|
type = with types; nullOr (enum ["default" "TPROXY" "ipfw" "pf-divert"]);
|
|
|
|
default = null;
|
|
|
|
};
|
|
|
|
#options.TruncateLogFile
|
|
|
|
options.UnixSocksGroupWritable = optionBool "UnixSocksGroupWritable";
|
|
|
|
options.UseDefaultFallbackDirs = optionBool "UseDefaultFallbackDirs";
|
|
|
|
options.UseMicrodescriptors = optionBool "UseMicrodescriptors";
|
|
|
|
options.V3AuthUseLegacyKey = optionBool "V3AuthUseLegacyKey";
|
|
|
|
options.V3AuthoritativeDirectory = optionBool "V3AuthoritativeDirectory";
|
|
|
|
options.VersioningAuthoritativeDirectory = optionBool "VersioningAuthoritativeDirectory";
|
|
|
|
options.VirtualAddrNetworkIPv4 = optionString "VirtualAddrNetworkIPv4";
|
|
|
|
options.VirtualAddrNetworkIPv6 = optionString "VirtualAddrNetworkIPv6";
|
|
|
|
options.WarnPlaintextPorts = optionPorts "WarnPlaintextPorts";
|
|
|
|
};
|
2017-08-11 21:59:52 +00:00
|
|
|
};
|
2010-05-16 16:20:00 +00:00
|
|
|
};
|
|
|
|
};
|
|
|
|
|
2014-12-06 09:37:31 +00:00
|
|
|
config = mkIf cfg.enable {
|
2017-03-01 00:00:00 +00:00
|
|
|
# Not sure if `cfg.relay.role == "private-bridge"` helps as tor
|
|
|
|
# sends a lot of stats
|
2020-09-11 05:46:59 +00:00
|
|
|
warnings = optional (cfg.settings.BridgeRelay &&
|
|
|
|
flatten (mapAttrsToList (n: o: o.map) cfg.relay.onionServices) != [])
|
2017-03-01 00:00:00 +00:00
|
|
|
''
|
|
|
|
Running Tor hidden services on a public relay makes the
|
|
|
|
presence of hidden services visible through simple statistical
|
|
|
|
analysis of publicly available data.
|
2020-09-11 05:46:59 +00:00
|
|
|
See https://trac.torproject.org/projects/tor/ticket/8742
|
2017-03-01 00:00:00 +00:00
|
|
|
|
|
|
|
You can safely ignore this warning if you don't intend to
|
|
|
|
actually hide your hidden services. In either case, you can
|
|
|
|
always create a container/VM with a separate Tor daemon instance.
|
2020-09-11 05:46:59 +00:00
|
|
|
'' ++
|
|
|
|
flatten (mapAttrsToList (n: o:
|
|
|
|
optional (o.settings.HiddenServiceVersion == 2) [
|
|
|
|
(optional (o.settings.HiddenServiceExportCircuitID != null) ''
|
|
|
|
HiddenServiceExportCircuitID is used in the HiddenService: ${n}
|
|
|
|
but this option is only for v3 hidden services.
|
|
|
|
'')
|
|
|
|
] ++
|
|
|
|
optional (o.settings.HiddenServiceVersion != 2) [
|
|
|
|
(optional (o.settings.HiddenServiceAuthorizeClient != null) ''
|
|
|
|
HiddenServiceAuthorizeClient is used in the HiddenService: ${n}
|
|
|
|
but this option is only for v2 hidden services.
|
|
|
|
'')
|
|
|
|
(optional (o.settings.RendPostPeriod != null) ''
|
|
|
|
RendPostPeriod is used in the HiddenService: ${n}
|
|
|
|
but this option is only for v2 hidden services.
|
|
|
|
'')
|
|
|
|
]
|
|
|
|
) cfg.relay.onionServices);
|
2017-03-01 00:00:00 +00:00
|
|
|
|
2018-06-29 23:58:35 +00:00
|
|
|
users.groups.tor.gid = config.ids.gids.tor;
|
|
|
|
users.users.tor =
|
2014-12-06 09:37:31 +00:00
|
|
|
{ description = "Tor Daemon User";
|
|
|
|
createHome = true;
|
2020-09-11 05:46:59 +00:00
|
|
|
home = stateDir;
|
2014-12-06 09:37:31 +00:00
|
|
|
group = "tor";
|
|
|
|
uid = config.ids.uids.tor;
|
2010-05-16 16:20:00 +00:00
|
|
|
};
|
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
services.tor.settings = mkMerge [
|
|
|
|
(mkIf cfg.enableGeoIP {
|
|
|
|
GeoIPFile = "${cfg.package.geoip}/share/tor/geoip";
|
|
|
|
GeoIPv6File = "${cfg.package.geoip}/share/tor/geoip6";
|
|
|
|
})
|
|
|
|
(mkIf cfg.controlSocket.enable {
|
|
|
|
ControlPort = [ { unix = runDir + "/control"; GroupWritable=true; RelaxDirModeCheck=true; } ];
|
|
|
|
})
|
|
|
|
(mkIf cfg.relay.enable (
|
|
|
|
optionalAttrs (cfg.relay.role != "exit") {
|
|
|
|
ExitPolicy = mkForce ["reject *:*"];
|
|
|
|
} //
|
|
|
|
optionalAttrs (elem cfg.relay.role ["bridge" "private-bridge"]) {
|
|
|
|
BridgeRelay = true;
|
|
|
|
ExtORPort.port = mkDefault "auto";
|
|
|
|
ServerTransportPlugin.transports = mkDefault ["obfs4"];
|
|
|
|
ServerTransportPlugin.exec = mkDefault "${pkgs.obfs4}/bin/obfs4proxy managed";
|
|
|
|
} // optionalAttrs (cfg.relay.role == "private-bridge") {
|
|
|
|
ExtraInfoStatistics = false;
|
|
|
|
PublishServerDescriptor = false;
|
|
|
|
}
|
|
|
|
))
|
|
|
|
(mkIf (!cfg.relay.enable) {
|
|
|
|
# Avoid surprises when leaving ORPort/DirPort configurations in cfg.settings,
|
|
|
|
# because it would still enable Tor as a relay,
|
|
|
|
# which can trigger all sort of problems when not carefully done,
|
|
|
|
# like the blocklisting of the machine's IP addresses
|
|
|
|
# by some hosting providers...
|
|
|
|
DirPort = mkForce [];
|
|
|
|
ORPort = mkForce [];
|
|
|
|
PublishServerDescriptor = mkForce false;
|
|
|
|
})
|
|
|
|
(mkIf cfg.client.enable (
|
|
|
|
{ SOCKSPort = [ cfg.client.socksListenAddress ];
|
|
|
|
} // optionalAttrs cfg.client.transparentProxy.enable {
|
|
|
|
TransPort = [{ addr = "127.0.0.1"; port = 9040; }];
|
|
|
|
} // optionalAttrs cfg.client.dns.enable {
|
|
|
|
DNSPort = [{ addr = "127.0.0.1"; port = 9053; }];
|
|
|
|
AutomapHostsOnResolve = true;
|
|
|
|
} // optionalAttrs (flatten (mapAttrsToList (n: o: o.clientAuthorizations) cfg.client.onionServices) != []) {
|
|
|
|
ClientOnionAuthDir = runDir + "/ClientOnionAuthDir";
|
|
|
|
}
|
|
|
|
))
|
|
|
|
];
|
2018-05-01 00:00:00 +00:00
|
|
|
|
2020-09-11 05:46:59 +00:00
|
|
|
networking.firewall = mkIf cfg.openFirewall {
|
|
|
|
allowedTCPPorts =
|
|
|
|
concatMap (o: optional (isInt o && o > 0 || o ? "port" && isInt o.port && o.port > 0) o.port)
|
|
|
|
(flatten [
|
|
|
|
cfg.settings.ORPort
|
|
|
|
cfg.settings.DirPort
|
|
|
|
]);
|
|
|
|
};
|
|
|
|
|
|
|
|
systemd.services.tor = {
|
|
|
|
description = "Tor Daemon";
|
|
|
|
path = [ pkgs.tor ];
|
|
|
|
|
|
|
|
wantedBy = [ "multi-user.target" ];
|
|
|
|
after = [ "network.target" ];
|
|
|
|
restartTriggers = [ torrc ];
|
|
|
|
|
|
|
|
serviceConfig = {
|
|
|
|
Type = "simple";
|
|
|
|
User = "tor";
|
|
|
|
Group = "tor";
|
|
|
|
ExecStartPre = [
|
|
|
|
"${cfg.package}/bin/tor -f ${torrc} --verify-config"
|
|
|
|
# DOC: Appendix G of https://spec.torproject.org/rend-spec-v3
|
|
|
|
("+" + pkgs.writeShellScript "ExecStartPre" (concatStringsSep "\n" (flatten (["set -eu"] ++
|
|
|
|
mapAttrsToList (name: onion:
|
|
|
|
optional (onion.authorizedClients != []) ''
|
|
|
|
rm -rf ${escapeShellArg onion.path}/authorized_clients
|
|
|
|
install -d -o tor -g tor -m 0700 ${escapeShellArg onion.path} ${escapeShellArg onion.path}/authorized_clients
|
|
|
|
'' ++
|
|
|
|
imap0 (i: pubKey: ''
|
|
|
|
echo ${pubKey} |
|
|
|
|
install -o tor -g tor -m 0400 /dev/stdin ${escapeShellArg onion.path}/authorized_clients/${toString i}.auth
|
|
|
|
'') onion.authorizedClients ++
|
|
|
|
optional (onion.secretKey != null) ''
|
|
|
|
install -d -o tor -g tor -m 0700 ${escapeShellArg onion.path}
|
|
|
|
key="$(cut -f1 -d: ${escapeShellArg onion.secretKey})"
|
|
|
|
case "$key" in
|
|
|
|
("== ed25519v"*"-secret")
|
|
|
|
install -o tor -g tor -m 0400 ${escapeShellArg onion.secretKey} ${escapeShellArg onion.path}/hs_ed25519_secret_key;;
|
|
|
|
(*) echo >&2 "NixOS does not (yet) support secret key type for onion: ${name}"; exit 1;;
|
|
|
|
esac
|
|
|
|
''
|
|
|
|
) cfg.relay.onionServices ++
|
|
|
|
mapAttrsToList (name: onion: imap0 (i: prvKeyPath:
|
|
|
|
let hostname = removeSuffix ".onion" name; in ''
|
|
|
|
printf "%s:" ${escapeShellArg hostname} | cat - ${escapeShellArg prvKeyPath} |
|
|
|
|
install -o tor -g tor -m 0700 /dev/stdin \
|
|
|
|
${runDir}/ClientOnionAuthDir/${escapeShellArg hostname}.${toString i}.auth_private
|
|
|
|
'') onion.clientAuthorizations)
|
|
|
|
cfg.client.onionServices
|
|
|
|
))))
|
|
|
|
];
|
|
|
|
ExecStart = "${cfg.package}/bin/tor -f ${torrc}";
|
|
|
|
ExecReload = "${pkgs.coreutils}/bin/kill -HUP $MAINPID";
|
|
|
|
KillSignal = "SIGINT";
|
|
|
|
TimeoutSec = 30;
|
|
|
|
Restart = "on-failure";
|
|
|
|
LimitNOFILE = 32768;
|
|
|
|
RuntimeDirectory = [
|
|
|
|
# g+x allows access to the control socket
|
|
|
|
"tor"
|
|
|
|
"tor/root"
|
|
|
|
# g+x can't be removed in ExecStart=, but will be removed by Tor
|
|
|
|
"tor/ClientOnionAuthDir"
|
|
|
|
];
|
|
|
|
RuntimeDirectoryMode = "0710";
|
|
|
|
StateDirectoryMode = "0700";
|
|
|
|
StateDirectory = [
|
|
|
|
"tor"
|
|
|
|
"tor/onion"
|
|
|
|
] ++
|
|
|
|
flatten (mapAttrsToList (name: onion:
|
|
|
|
optional (onion.secretKey == null) "tor/onion/${name}"
|
|
|
|
) cfg.relay.onionServices);
|
|
|
|
# The following options are only to optimize:
|
|
|
|
# systemd-analyze security tor
|
|
|
|
RootDirectory = runDir + "/root";
|
|
|
|
RootDirectoryStartOnly = true;
|
|
|
|
#InaccessiblePaths = [ "-+${runDir}/root" ];
|
|
|
|
UMask = "0066";
|
|
|
|
BindPaths = [ stateDir ];
|
|
|
|
BindReadOnlyPaths = [ storeDir "/etc" ];
|
|
|
|
AmbientCapabilities = [""] ++ lib.optional bindsPrivilegedPort "CAP_NET_BIND_SERVICE";
|
|
|
|
CapabilityBoundingSet = [""] ++ lib.optional bindsPrivilegedPort "CAP_NET_BIND_SERVICE";
|
|
|
|
# ProtectClock= adds DeviceAllow=char-rtc r
|
|
|
|
DeviceAllow = "";
|
|
|
|
LockPersonality = true;
|
|
|
|
MemoryDenyWriteExecute = true;
|
|
|
|
NoNewPrivileges = true;
|
|
|
|
PrivateDevices = true;
|
|
|
|
PrivateMounts = true;
|
|
|
|
PrivateNetwork = mkDefault false;
|
|
|
|
PrivateTmp = true;
|
|
|
|
# Tor cannot currently bind privileged port when PrivateUsers=true,
|
|
|
|
# see https://gitlab.torproject.org/legacy/trac/-/issues/20930
|
|
|
|
PrivateUsers = !bindsPrivilegedPort;
|
|
|
|
ProtectClock = true;
|
|
|
|
ProtectControlGroups = true;
|
|
|
|
ProtectHome = true;
|
|
|
|
ProtectHostname = true;
|
|
|
|
ProtectKernelLogs = true;
|
|
|
|
ProtectKernelModules = true;
|
|
|
|
ProtectKernelTunables = true;
|
|
|
|
ProtectSystem = "strict";
|
|
|
|
RemoveIPC = true;
|
|
|
|
RestrictAddressFamilies = [ "AF_UNIX" "AF_INET" "AF_INET6" ];
|
|
|
|
RestrictNamespaces = true;
|
|
|
|
RestrictRealtime = true;
|
|
|
|
RestrictSUIDSGID = true;
|
|
|
|
# See also the finer but experimental option settings.Sandbox
|
|
|
|
SystemCallFilter = [
|
|
|
|
"@system-service"
|
|
|
|
# Groups in @system-service which do not contain a syscall listed by:
|
|
|
|
# perf stat -x, 2>perf.log -e 'syscalls:sys_enter_*' tor
|
|
|
|
# in tests, and seem likely not necessary for tor.
|
|
|
|
"~@aio" "~@chown" "~@keyring" "~@memlock" "~@resources" "~@setuid" "~@timer"
|
|
|
|
];
|
|
|
|
SystemCallArchitectures = "native";
|
|
|
|
SystemCallErrorNumber = "EPERM";
|
2014-12-06 09:37:31 +00:00
|
|
|
};
|
2020-09-11 05:46:59 +00:00
|
|
|
};
|
2011-09-14 18:20:50 +00:00
|
|
|
|
2020-08-30 17:15:43 +00:00
|
|
|
environment.systemPackages = [ cfg.package ];
|
2013-10-30 17:30:23 +00:00
|
|
|
};
|
2020-09-11 05:46:59 +00:00
|
|
|
|
|
|
|
meta.maintainers = with lib.maintainers; [ julm ];
|
2010-05-16 16:20:00 +00:00
|
|
|
}
|