forked from SentryPeer/SentryPeer
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathsentrypeer.1
71 lines (67 loc) · 2.76 KB
/
sentrypeer.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
.TH SentryPeer 1 "December 2021" "SentryPeer"
.SH NAME
sentrypeer \- A distributed list of bad IP addresses and phone numbers collected via a SIP Honeypot
.SH SYNOPSIS
.B sentrypeer
[\-hVfadrsvw]
.SH DESCRIPTION
.B SentryPeer
is basically a fraud detection tool. It lets bad actors try to make phone calls and saves the IP address they came
from and number they tried to call. Those details are then used to block them at the service providers network and the
next time a user/customer tries to call a collected number, it's blocked.
Traditionally this data is shipped to a central place, so you don't own the data you've collected. This project is all
about Peer to Peer sharing of that data. The user owning the data and various Service Provider / Network Provider
related feeds of the data is the key bit for me. I'm sick of all the services out there that keep it and sell it.
If you've collected it, you should have the choice to keep it and/or opt in to share it with other SentryPeer community
members via p2p methods.
.SH OPTIONS
.TP
.BI "-h
Shows the help screen
.TP
.BI "\-V
shows the version of SentryPeer
.TP
.BI "\-f
Set 'sentrypeer.db' location or set SENTRYPEER_DB_FILE environment variable
.TP
.BI "\-a
Runs SentryPeer with the RESTful API or set SENTRYPEER_API=1 environment variable
.TP
.BI "\-r
Runs SentryPeer in SIP responsive mode or set SENTRYPEER_SIP_RESPONSIVE=1 environment variable. Enables replies to SIP
probes to prompt INVITEs and actual attacks
.TP
.BI "\-s
Runs SentryPeer with syslog logging or set SENTRYPEER_SYSLOG=1 environment variable. Allows Fail2ban to use SentryPeer
to block IP addresses
.TP
.BI "\-v
Runs SentryPeer in verbose mode or set SENTRYPEER_VERBOSE=1 environment variable
.TP
.BI "\-w
Runs SentryPeer with the Web GUI enabled or set SENTRYPEER_WEB_GUI=1 environment variable
.TP
.BI "-d
Runs SentryPeer in debug mode (preferred method at the moment) or set SENTRYPEER_DEBUG=1 environment variable
.SH USING SENTRYPEER
You can run SentryPeer via the console, use a Docker image via Docker Hub, build your own container with the Dockerfile
on GitHub or install a deb or rpm. It looks like you installed from source or a package if you're reading this :-) Peer
to Peer is the next step.
.SH BUGS
Issues and can be raised on the SentryPeer GitHub page:
<https://github.com/ghenry/SentryPeer/issues>
It's okay to raise an issue to ask a question.
.br
.SH SEE ALSO
<https://sentrypeer.org>
.SH LICENSE
Copyright (c) 2021 - 2022 Gavin Henry <[email protected]>
.br
License GPLv2 or GPLv3: GNU GPL version 2 or version 3 <https://www.gnu.org/licenses/gpl.html>
This is free software; you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH AUTHORS/CREDITS
.B SentryPeer
was written by Gavin Henry
.B <[email protected]>