Skip to content

Commit 9164067

Browse files
committed
Add document about proxy settings to README.md
1 parent 089e36a commit 9164067

File tree

1 file changed

+37
-3
lines changed

1 file changed

+37
-3
lines changed

README.md

Lines changed: 37 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Stores files on a SFTP Server
1414
## Configuration
1515

1616
- **host**: (string, required)
17-
- **port**: (string, default: `22`)
17+
- **port**: (int, default: `22`)
1818
- **user**: (string, required)
1919
- **password**: (string, default: `null`)
2020
- **secret_key_file**: (string, default: `null`) [see below](#secret-keyfile-configuration)
@@ -25,6 +25,19 @@ Stores files on a SFTP Server
2525
- **file_ext**: Extension of output files (string, required)
2626
- **sequence_format**: Format for sequence part of output files (string, default: `".%03d.%02d"`)
2727

28+
### Proxy configuration
29+
30+
- **proxy**:
31+
- **type**: (string(http | socks | stream), required, default: `null`)
32+
- **http**: use HTTP Proxy
33+
- **socks**: use SOCKS Proxy
34+
- **stream**: Connects to the SFTP server through a remote host reached by SSH
35+
- **host**: (string, required)
36+
- **port**: (int, default: `22`)
37+
- **user**: (string, optional)
38+
- **password**: (string, optional, default: `null`)
39+
- **command**: (string, optional)
40+
2841
## Example
2942

3043
```yaml
@@ -42,10 +55,31 @@ out:
4255
sequence_format: ".%01d%01d"
4356
```
4457
58+
With proxy
59+
```yaml
60+
out:
61+
type: sftp
62+
host: 127.0.0.1
63+
port: 22
64+
user: embulk
65+
secret_key_file: /Users/embulk/.ssh/id_rsa
66+
secret_key_passphrase: secret_pass
67+
user_directory_is_root: false
68+
timeout: 600
69+
path_prefix: /data/sftp
70+
proxy:
71+
type: http
72+
host: proxy_host
73+
port: 8080
74+
user: proxy_user
75+
password: proxy_secret_pass
76+
command:
77+
```
78+
4579
### Secret Keyfile configuration
4680
4781
Please set path of secret_key_file as follows.
48-
```
82+
```yaml
4983
out:
5084
type: sftp
5185
...
@@ -54,7 +88,7 @@ out:
5488
```
5589

5690
You can also embed contents of secret_key_file at config.yml.
57-
```
91+
```yaml
5892
out:
5993
type: sftp
6094
...

0 commit comments

Comments
 (0)