doc: Add section about how to change the sftp port

Closes #895
Related to #785
This commit is contained in:
Alexander Neumann 2017-03-25 09:06:46 +01:00
parent c85055bb03
commit 1733b24f9d
2 changed files with 37 additions and 4 deletions

View file

@ -517,6 +517,40 @@ You can also specify a relative (read: no slash (`/`) character at the
beginning) directory, in this case the dir is relative to the remote user's
home directory.
The backend config string does not allow specifying a port. If you need to
contact an sftp server on a different port, you can create an entry in the
`ssh` file, usually located in your user's home directory at `~/.ssh/config` or
in `/etc/ssh/ssh_config`:
```
Host foo
User bar
Port 2222
```
Then use the specified host name `foo` normally (you don't need to specify the
user name in this case):
```
$ restic -r sftp:foo:/tmp/backup init
```
You can also add an entry with a special host name which does not exist, just
for use with restic, and use the `Hostname` option to set the real host name:
```
Host restic-backup-host
Hostname foo
User bar
Port 2222
```
Then use it in the backend specification:
```
$ restic -r sftp:restic-backup-host:/tmp/backup init
```
# Create a REST server repository
In order to backup data to the remote server via HTTP or HTTPS protocol,

View file

@ -15,10 +15,9 @@ type Config struct {
// ParseConfig parses the string s and extracts the sftp config. The
// supported configuration formats are sftp://user@host/directory
// (with an optional port sftp://user@host:port/directory) and
// sftp:user@host:directory. The directory will be path Cleaned and
// can be an absolute path if it starts with a '/'
// (e.g. sftp://user@host//absolute and sftp:user@host:/absolute).
// and sftp:user@host:directory. The directory will be path Cleaned and can
// be an absolute path if it starts with a '/' (e.g.
// sftp://user@host//absolute and sftp:user@host:/absolute).
func ParseConfig(s string) (interface{}, error) {
var user, host, dir string
switch {