Jelajahi Sumber

Updated documentation.

default 2 tahun lalu
induk
melakukan
cc0fc68d7c
2 mengubah file dengan 29 tambahan dan 4 penghapusan
  1. 3 1
      doc/snac.5
  2. 26 3
      doc/snac.8

+ 3 - 1
doc/snac.5

@@ -110,7 +110,9 @@ This file contains the list of public posts from all users in the server.
 This (optional) file contains a list of regular expressions, one per line, to be
 This (optional) file contains a list of regular expressions, one per line, to be
 applied to the content of all incoming posts; if any of them match, the post is
 applied to the content of all incoming posts; if any of them match, the post is
 rejected. This brings the flexibility and destruction power of regular expressions
 rejected. This brings the flexibility and destruction power of regular expressions
-to your Fediverse experience. To be used wisely.
+to your Fediverse experience. To be used wisely (see
+.Xr snac 8
+for more information).
 .El
 .El
 .Pp
 .Pp
 Each user directory is a subdirectory of 
 Each user directory is a subdirectory of 

+ 26 - 3
doc/snac.8

@@ -230,9 +230,32 @@ for details. Further, every user can have a private CSS file in their
 that will be served instead of the server-wide one.
 that will be served instead of the server-wide one.
 It's not modifiable from the web interface to avoid users
 It's not modifiable from the web interface to avoid users
 shooting themselves in the foot by destroying everything.
 shooting themselves in the foot by destroying everything.
-.Ss Old Data Purging
-From version 2.06, there is no longer a need to add a special
-cron job for purging old data, as this is managed internally.
+.Ss SPAM Mitigation
+There have been some SPAM attacks on the Fediverse and, as too many
+instances and server implementations out there still allow automatic
+account creation, it will only get worse.
+.Nm
+includes some (not very strong) tools for trying to survive the SPAM
+flood that will eventually happen.
+.Pp
+The 
+.Ic min_account_age
+field in the main configuration file allows setting a minimum age (in
+seconds) to consider too recently created accounts suspicious of being
+a potential source of SPAM. This is a naïve assumption, because spammers
+can create accounts, let them dormant for a while and then start to use
+them. Also, some ActivityPub implementations don't even bother to return
+a creation date for their accounts, so this is not very useful.
+.Pp
+From version 2.50, post content can be filtered out by regular expressions.
+These weapons of mass destruction can be written into the
+.Ic filter_reject.txt
+file in the server base directory, one per line; if this file exists,
+all posts' content will be matched against these regexes, one by one, and
+any match will make the post to be rejected. If you don't know about regular
+expressions, don't use this option (or learn about them in some tutorial,
+there are gazillions of them out there), as you and your users may start
+missing posts.
 .Ss ActivityPub Support
 .Ss ActivityPub Support
 These are the following activities and objects that
 These are the following activities and objects that
 .Nm
 .Nm