commit cc0fc68

default  ·  2024-03-12 09:48:13 +0000 UTC
parent 7a1751c
Updated documentation.
2 files changed,  +29, -4
+3, -1
 1@@ -110,7 +110,9 @@ This file contains the list of public posts from all users in the server.
 2 This (optional) file contains a list of regular expressions, one per line, to be
 3 applied to the content of all incoming posts; if any of them match, the post is
 4 rejected. This brings the flexibility and destruction power of regular expressions
 5-to your Fediverse experience. To be used wisely.
 6+to your Fediverse experience. To be used wisely (see
 7+.Xr snac 8
 8+for more information).
 9 .El
10 .Pp
11 Each user directory is a subdirectory of 
+26, -3
 1@@ -230,9 +230,32 @@ for details. Further, every user can have a private CSS file in their
 2 that will be served instead of the server-wide one.
 3 It's not modifiable from the web interface to avoid users
 4 shooting themselves in the foot by destroying everything.
 5-.Ss Old Data Purging
 6-From version 2.06, there is no longer a need to add a special
 7-cron job for purging old data, as this is managed internally.
 8+.Ss SPAM Mitigation
 9+There have been some SPAM attacks on the Fediverse and, as too many
10+instances and server implementations out there still allow automatic
11+account creation, it will only get worse.
12+.Nm
13+includes some (not very strong) tools for trying to survive the SPAM
14+flood that will eventually happen.
15+.Pp
16+The 
17+.Ic min_account_age
18+field in the main configuration file allows setting a minimum age (in
19+seconds) to consider too recently created accounts suspicious of being
20+a potential source of SPAM. This is a naïve assumption, because spammers
21+can create accounts, let them dormant for a while and then start to use
22+them. Also, some ActivityPub implementations don't even bother to return
23+a creation date for their accounts, so this is not very useful.
24+.Pp
25+From version 2.50, post content can be filtered out by regular expressions.
26+These weapons of mass destruction can be written into the
27+.Ic filter_reject.txt
28+file in the server base directory, one per line; if this file exists,
29+all posts' content will be matched against these regexes, one by one, and
30+any match will make the post to be rejected. If you don't know about regular
31+expressions, don't use this option (or learn about them in some tutorial,
32+there are gazillions of them out there), as you and your users may start
33+missing posts.
34 .Ss ActivityPub Support
35 These are the following activities and objects that
36 .Nm