updated readme

This commit is contained in:
annelin 2019-04-16 09:09:34 +03:00
parent 84ebb98b5b
commit b80984cc3e
2 changed files with 98 additions and 27 deletions

View file

@ -10,18 +10,20 @@
### Installation ### ### Installation ###
First of all, you need to create component listener on your Jabber server. First of all, you need to create component listener on your Jabber server.
For example, for ejabberd: For example, for ejabberd in **/etc/ejabberd/ejabberd.yml**:
``` ```
port: 8888 listen:
module: ejabberd_service -
access: all port: 8888
shaper_rule: fast module: ejabberd_service
ip: "127.0.0.1" access: all
service_check_from: false shaper_rule: fast
hosts: ip: "127.0.0.1"
"telegram.jabber.ru": service_check_from: false
password: "secret" hosts:
"telegram.jabber.ru":
password: "secret"
``` ```
@ -38,4 +40,72 @@ xmpp:
loglevel: 0 loglevel: 0
``` ```
If neccessary, edit **telegram** section too. ### Configuration ###
Feel free to edit **config.yml**, options are commented and with clear names.
It is good idea to obtain Telegram API ID from [my.telegram.org](https://my.telegram.org) to remove demo key requests limit.
### How to receive files from Telegram ###
First of all, you need to set up web server that will serve some directory in your filesystem.
Example nginx config:
```
server {
listen 80;
server_name tlgrm.localhost;
location /content {
alias /var/zhabogram;
}
}
```
You need to set `content_path` and `content_link` in **config.yml**.
Set `content_path` according to location (for our example it will be `/var/zhabogram/content`).
Set `content_link` according to server_name (for our example it will be `http://tlgrm.localhost`)
### How to send files to Telegram chats ###
You need to setup `mod_http_upload` for your XMPP server.
For example, for ejabberd in **/etc/ejabberd/ejabberd.yml**
```
modules:
mod_http_upload:
docroot: "/var/ejabberd/upload" # this must be a valid path, user ownership and SELinux flags must be set accordingly
put_url: "https://xmpp.localhost:5443/upload/@HOST@"
get_url: "https://xmppfiles.localhost/upload/@HOST@"
access: local
max_size: 500000000 #500 MByte
thumbnail: false
file_mode: "0644"
dir_mode: "0744"
```
Then you need to setup nginx proxy that will serve `get_url` path, because Telegram do not allowing URLs with non-default ports.
Example nginx config:
```
server {
listen 80;
listen 443 ssl;
server_name xmppfiles.localhost;
# SSL settigns #
keepalive_timeout 60;
ssl_certificate /etc/ssl/domain.crt;
ssl_certificate_key /etc/ssl/domain.key;
ssl_protocols SSLv3 TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers "RC4:HIGH:!aNULL:!MD5:!kEDH";
add_header Strict-Transport-Security 'max-age=604800';
location / {
proxy_pass https://xmpp.localhost:5443;
}
}
```

View file

@ -1,21 +1,22 @@
telegram: telegram:
api_id: '17349' api_id: '17349' # telegram API ID (my.telegram.org) #
api_hash: '344583e45741c457fe1862106095a5eb' api_hash: '344583e45741c457fe1862106095a5eb' # telegram API HASH (my.telegram.org) #
verbosity: 2 verbosity: 2 # 1 = no verbosity, 2 = moderate verbosity, 3 = network requests debug
useragent: 'Zhabogram XMPP Gateway' useragent: 'Zhabogram XMPP Gateway' # client name
version: '0.7' version: '0.8' # client version
use_test_dc: false use_test_dc: false # always use false
loglevel: 0 loglevel: 0 # 0 = debug, 1 = info, 2 = warn, 3 = err, 4 = fatal, 5 = unknown (ruby logger class)
content_path: '/var/www/tg_media' content_path: '/var/www/tg_media' # we will move (symlink) downloaded content here — you must setup web server that serve this directry
content_link: 'https://localhost/tg_media' content_link: 'https://localhost/tg_media' # web server that serve `content_path` internet address
content_upload_prefix: 'https://localhost/upload' content_upload_prefix: 'https://localhost/upload' # we will send files with URL starting with this string as document to Telegram (mod_http_upload get_url, see readme)
xmpp: xmpp:
db_path: 'users.db' db_path: 'users.db' # sqlite3 users (JID:Telegram Login) database
jid: 'tlgrm.localhost' jid: 'tlgrm.localhost' # component JID
host: 'localhost' host: 'localhost' # XMPP server
port: 8899 port: 8899 # component port
secret: 'password' secret: 'password' # component auth secret
loglevel: 0 loglevel: 0 # 0 = debug, 1 = info, 2 = warn, 3 = err, 4 = fatal, 5 = unknown (ruby logger class)