@@ -100,21 +100,19 @@ config file at runtime.
100
100
- [ ` Swarm.DisableBandwidthMetrics ` ] ( #swarmdisablebandwidthmetrics )
101
101
- [ ` Swarm.DisableNatPortMap ` ] ( #swarmdisablenatportmap )
102
102
- [ ` Swarm.DisableRelay ` ] ( #swarmdisablerelay )
103
- - [ ` Swarm.DisableRelayService ` ] ( #swarmdisablerelayservice )
104
- - [ ` Swarm.RelayServiceOpts ` ] ( #swarmrelayserviceopts )
105
- - [ ` Swarm.RelayServiceOpts .Limit ` ] ( #swarmrelayserviceoptslimit )
106
- - [ ` Swarm.RelayServiceOpts .Limit.Duration ` ] ( #swarmrelayserviceoptslimitduration )
107
- - [ ` Swarm.RelayServiceOpts .Limit.Data ` ] ( #swarmrelayserviceoptslimitdata )
108
- - [ ` Swarm.RelayServiceOpts .ReservationTTL ` ] ( #swarmrelayserviceoptsreservationttl )
109
- - [ ` Swarm.RelayServiceOpts .MaxReservations ` ] ( #swarmrelayserviceoptsmaxreservations )
110
- - [ ` Swarm.RelayServiceOpts .MaxCircuits ` ] ( #swarmrelayserviceoptsmaxcircuits )
111
- - [ ` Swarm.RelayServiceOpts .BufferSize ` ] ( #swarmrelayserviceoptsbuffersize )
112
- - [ ` Swarm.RelayServiceOpts .MaxReservationsPerPeer ` ] ( #swarmrelayserviceoptsmaxreservationsperpeer )
113
- - [ ` Swarm.RelayServiceOpts .MaxReservationsPerIP ` ] ( #swarmrelayserviceoptsmaxreservationsperip )
114
- - [ ` Swarm.RelayServiceOpts .MaxReservationsPerASN ` ] ( #swarmrelayserviceoptsmaxreservationsperasn )
103
+ - [ ` Swarm.RelayService ` ] ( #swarmrelayservice )
104
+ - [ ` Swarm.RelayService.Enabled ` ] ( #swarmrelayserviceenabled )
105
+ - [ ` Swarm.RelayService .Limit ` ] ( #swarmrelayservicelimit )
106
+ - [ ` Swarm.RelayService .Limit.Duration ` ] ( #swarmrelayservicelimitduration )
107
+ - [ ` Swarm.RelayService .Limit.Data ` ] ( #swarmrelayservicelimitdata )
108
+ - [ ` Swarm.RelayService .ReservationTTL ` ] ( #swarmrelayservicereservationttl )
109
+ - [ ` Swarm.RelayService .MaxReservations ` ] ( #swarmrelayservicemaxreservations )
110
+ - [ ` Swarm.RelayService .MaxCircuits ` ] ( #swarmrelayservicemaxcircuits )
111
+ - [ ` Swarm.RelayService .BufferSize ` ] ( #swarmrelayservicebuffersize )
112
+ - [ ` Swarm.RelayService .MaxReservationsPerPeer ` ] ( #swarmrelayservicemaxreservationsperpeer )
113
+ - [ ` Swarm.RelayService .MaxReservationsPerIP ` ] ( #swarmrelayservicemaxreservationsperip )
114
+ - [ ` Swarm.RelayService .MaxReservationsPerASN ` ] ( #swarmrelayservicemaxreservationsperasn )
115
115
- [ ` Swarm.EnableAutoRelay ` ] ( #swarmenableautorelay )
116
- - [ Mode 1: ` EnableRelayHop ` is ` false ` ] ( #mode-1-enablerelayhop-is-false )
117
- - [ Mode 2: ` EnableRelayHop ` is ` true ` ] ( #mode-2-enablerelayhop-is-true )
118
116
- [ ` Swarm.EnableAutoNATService ` ] ( #swarmenableautonatservice )
119
117
- [ ` Swarm.ConnMgr ` ] ( #swarmconnmgr )
120
118
- [ ` Swarm.ConnMgr.Type ` ] ( #swarmconnmgrtype )
@@ -1291,133 +1289,133 @@ Default: `false`
1291
1289
1292
1290
Type: ` bool `
1293
1291
1294
- ### ` Swarm.DisableRelayService `
1292
+ ### ` Swarm.RelayService `
1295
1293
1296
- Disables the p2p-circuit v2 relay service. This will prevent this node from
1297
- running as a relay server.
1294
+ Configuration options for the relay service.
1298
1295
1299
- Default: ` false `
1296
+ Default: ` {} `
1300
1297
1301
- Type: ` bool `
1298
+ Type: ` object `
1302
1299
1303
- ### ` Swarm.RelayServiceOpts `
1300
+ ### ` Swarm.RelayService.Enabled `
1304
1301
1305
- Configuration options for the relay service.
1302
+ Enables the p2p-circuit v2 relay service. Disabling this will prevent this node
1303
+ from running as a relay server.
1306
1304
1307
- Default: ` {} `
1305
+ Default: Enabled
1308
1306
1309
- Type: ` object `
1307
+ Type: ` flag `
1310
1308
1311
- #### ` Swarm.RelayServiceOpts .Limit `
1309
+ #### ` Swarm.RelayService .Limit `
1312
1310
1313
1311
Limits applied to every relayed connection.
1314
1312
1315
1313
Default: ` {} `
1316
1314
1317
1315
Type: ` object[string -> string] `
1318
1316
1319
- ##### ` Swarm.RelayServiceOpts .Limit.Duration `
1317
+ ##### ` Swarm.RelayService .Limit.Duration `
1320
1318
1321
1319
Time limit before a relayed connection is reset.
1322
1320
1323
1321
Default: ` "2m" `
1324
1322
1325
- Type: ` string `
1326
-
1323
+ Type: ` duration `
1327
1324
1328
- ##### ` Swarm.RelayServiceOpts .Limit.Data `
1325
+ ##### ` Swarm.RelayService .Limit.Data `
1329
1326
1330
1327
Limit of data relayed (in each direction) before a relayed connection is reset.
1331
1328
1332
1329
Default: ` 131072 ` (128 kb)
1333
1330
1334
- Type: ` integer `
1331
+ Type: ` optionalInteger `
1335
1332
1336
1333
1337
- #### ` Swarm.RelayServiceOpts .ReservationTTL `
1334
+ #### ` Swarm.RelayService .ReservationTTL `
1338
1335
1339
1336
Duration of a new or refreshed reservation.
1340
1337
1341
1338
Default: ` "1h" `
1342
1339
1343
- Type: ` string `
1340
+ Type: ` duration `
1344
1341
1345
1342
1346
- #### ` Swarm.RelayServiceOpts .MaxReservations `
1343
+ #### ` Swarm.RelayService .MaxReservations `
1347
1344
1348
1345
Maximum number of active relay slots.
1349
1346
1350
1347
Default: ` 128 `
1351
1348
1352
- Type: ` integer `
1349
+ Type: ` optionalInteger `
1353
1350
1354
1351
1355
- #### ` Swarm.RelayServiceOpts .MaxReservations `
1352
+ #### ` Swarm.RelayService .MaxReservations `
1356
1353
1357
1354
Maximum number of open relay connections for each peer.
1358
1355
1359
1356
Default: ` 16 `
1360
1357
1361
- Type: ` integer `
1358
+ Type: ` optionalInteger `
1362
1359
1363
1360
1364
- #### ` Swarm.RelayServiceOpts .BufferSize `
1361
+ #### ` Swarm.RelayService .BufferSize `
1365
1362
1366
1363
Size of the relayed connection buffers.
1367
1364
1368
1365
Default: ` 2048 `
1369
1366
1370
- Type: ` integer `
1367
+ Type: ` optionalInteger `
1371
1368
1372
1369
1373
- #### ` Swarm.RelayServiceOpts .MaxReservationsPerPeer `
1370
+ #### ` Swarm.RelayService .MaxReservationsPerPeer `
1374
1371
1375
1372
Maximum number of reservations originating from the same peer.
1376
1373
1377
1374
Default: ` 4 `
1378
1375
1379
- Type: ` integer `
1376
+ Type: ` optionalInteger `
1380
1377
1381
1378
1382
- #### ` Swarm.RelayServiceOpts .MaxReservationsPerIP `
1379
+ #### ` Swarm.RelayService .MaxReservationsPerIP `
1383
1380
1384
1381
Maximum number of reservations originating from the same IP.
1385
1382
1386
1383
Default: ` 8 `
1387
1384
1388
- Type: ` integer `
1389
-
1385
+ Type: ` optionalInteger `
1390
1386
1391
- #### ` Swarm.RelayServiceOpts .MaxReservationsPerASN `
1387
+ #### ` Swarm.RelayService .MaxReservationsPerASN `
1392
1388
1393
1389
Maximum number of reservations originating from the same ASN.
1394
1390
1395
1391
Default: ` 32 `
1396
1392
1397
- Type: ` integer `
1398
-
1393
+ Type: ` optionalInteger `
1399
1394
1400
1395
### ` Swarm.EnableRelayHop `
1401
1396
1402
1397
** REMOVED**
1403
1398
1404
1399
Please use [ ` Swarm.DisableRelayService ` ] [ ] .
1405
1400
1406
-
1407
1401
### ` Swarm.EnableAutoRelay `
1408
1402
1409
- Enables "automatic relay" mode for this node. This option does two _ very_
1410
- different things based on the ` Swarm.EnableRelayHop ` . See
1411
- [ #7228 ] ( https://github.com/ipfs/go-ipfs/issues/7228 ) for context.
1412
-
1413
- Default: ` false `
1414
-
1415
- Type: ` bool `
1403
+ Enables "automatic relay" mode for this node.
1416
1404
1417
1405
Your node will automatically _ use_ public relays from the network if it detects
1418
1406
that it cannot be reached from the public internet (e.g., it's behind a
1419
1407
firewall). This is likely the feature you're looking for.
1420
1408
1409
+ See also:
1410
+
1411
+ - [ ` Swarm.Transports.Network.Relay ` ] ( #swarmtransportsnetworkrelay ) to control
1412
+ relay transport (as a client)
1413
+ - [ ` Swarm.RelayService.Enabled ` ] ( #swarmrelayserviceenabled ) to control if your
1414
+ node should act as a limited relay when possible
1415
+
1416
+ Default: ` false `
1417
+
1418
+ Type: ` bool `
1421
1419
1422
1420
### ` Swarm.EnableAutoNATService `
1423
1421
0 commit comments