如何在 Node.js Axios 中使用代理：完整指南

TL;DR

在 Node.js 中为 Axios 配置 GProxy 代理以发送 HTTP 请求。涵盖代理配置、HTTPS 支持、轮换模式和错误处理。

获取代理 → Node.js Axios 网站 →

语言: JavaScript

准备事项

✓[
✓"
✓已
✓安
✓装
✓
✓N
✓o
✓d
✓e
✓.
✓j
✓s
✓
✓1
✓6
✓+
✓"
✓,
✓
✓"
✓已
✓安
✓装
✓
✓A
✓x
✓i
✓o
✓s
✓（
✓n
✓p
✓m
✓
✓i
✓n
✓s
✓t
✓a
✓l
✓l
✓
✓a
✓x
✓i
✓o
✓s
✓）
✓"
✓,
✓
✓"
✓拥
✓有
✓有
✓效
✓代
✓理
✓套
✓餐
✓的
✓
✓G
✓P
✓r
✓o
✓x
✓y
✓
✓账
✓户
✓"
✓,
✓
✓"
✓基
✓本
✓的
✓
✓N
✓o
✓d
✓e
✓.
✓j
✓s
✓
✓与
✓
✓a
✓s
✓y
✓n
✓c
✓/
✓a
✓w
✓a
✓i
✓t
✓
✓知
✓识
✓"
✓]

分步设置

[

{

"

T

I

T

L

E

"

:

"

安

装

A

X

I

O

S

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

安

装

A

X

I

O

S

及

可

选

的

S

O

C

K

S

5 支

持

"

,

"

C

O

D

E

"

:

"

N

P

M

I

N

S

T

A

L

A

X

I

O

S

\

N

#

如

需

S

100

O

101

C

102

K

103

S

104

5

105

106

支

107

持

108

：

109

\

110

N

111

N

112

P

113

M

114

115

I

116

N

117

S

118

T

119

A

120

L

121

L

122

123

S

124

O

125

C

126

K

127

S

128

-

129

P

130

R

131

O

132

X

133

Y

134

-

135

A

136

G

137

E

138

N

139

T

140

"

141

}

142

,

143

144

{

145

"

146

T

147

I

148

T

149

L

150

E

151

"

152

:

153

154

"

155

配

156

置

157

158

H

159

T

160

T

161

P

162

163

代

164

理

165

"

166

,

167

168

"

169

D

170

E

171

S

172

C

173

R

174

I

175

P

176

T

177

I

178

O

179

N

180

"

181

:

182

183

"

184

将

185

186

G

187

P

188

R

189

O

190

X

191

Y

192

193

代

194

理

195

加

196

入

197

198

A

199

X

200

I

201

O

202

S

203

204

请

205

求

206

配

207

置

208

"

209

,

210

211

"

212

C

213

O

214

D

215

E

216

"

217

:

218

219

"

220

C

221

O

222

N

223

S

224

T

225

226

A

227

X

228

I

229

O

230

S

231

232

=

233

234

R

235

E

236

Q

237

U

238

I

239

R

240

E

241

(

242

'

243

A

244

X

245

I

246

O

247

S

248

'

249

)

250

;

251

\

252

N

253

\

254

N

255

C

256

O

257

N

258

S

259

T

260

261

R

262

E

263

S

264

P

265

O

266

N

267

S

268

E

269

270

=

271

272

A

273

W

274

A

275

I

276

T

277

278

A

279

X

280

I

281

O

282

S

283

.

284

G

285

E

286

T

287

(

288

'

289

H

290

T

291

T

292

P

293

S

294

:

295

/

296

/

297

H

298

T

299

T

300

P

301

B

302

I

303

N

304

.

305

O

306

R

307

G

308

/

309

I

310

P

311

'

312

,

313

314

{

315

\

316

N

317

318

319

P

320

R

321

O

322

X

323

Y

324

:

325

326

{

327

\

328

N

329

330

331

332

333

H

334

O

335

S

336

T

337

:

338

339

'

340

P

341

R

342

O

343

X

344

Y

345

.

346

G

347

P

348

R

349

O

350

X

351

Y

352

.

353

N

354

E

355

T

356

'

357

,

358

\

359

N

360

361

362

363

364

P

365

O

366

R

367

T

368

:

369

370

1

371

0

372

0

373

0

374

,

375

\

376

N

377

378

379

380

381

A

382

U

383

T

384

H

385

:

386

387

{

388

389

U

390

S

391

E

392

R

393

N

394

A

395

M

396

E

397

:

398

399

'

400

Y

401

O

402

U

403

R

404

_

405

U

406

S

407

E

408

R

409

'

410

,

411

412

P

413

A

414

S

415

S

416

W

417

O

418

R

419

D

420

:

421

422

'

423

Y

424

O

425

U

426

R

427

_

428

P

429

A

430

S

431

S

432

'

433

434

}

435

\

436

N

437

438

439

}

440

\

441

N

442

}

443

)

444

;

445

\

446

N

447

C

448

O

449

N

450

S

451

O

452

L

453

E

454

.

455

L

456

O

457

G

458

(

459

R

460

E

461

S

462

P

463

O

464

N

465

S

466

E

467

.

468

D

469

A

470

T

471

A

472

)

473

;

474

"

475

}

476

,

477

478

{

479

"

480

T

481

I

482

T

483

L

484

E

485

"

486

:

487

488

"

489

设

490

置

491

492

S

493

O

494

C

495

K

496

S

497

5

498

499

代

500

理

501

"

502

,

503

504

"

505

D

506

E

507

S

508

C

509

R

510

I

511

P

512

T

513

I

514

O

515

N

516

"

517

:

518

519

"

520

使

521

用

522

523

S

524

O

525

C

526

K

527

S

528

-

529

P

530

R

531

O

532

X

533

Y

534

-

535

A

536

G

537

E

538

N

539

T

540

541

获

542

得

543

544

S

545

O

546

C

547

K

548

S

549

5

550

551

支

552

持

553

"

554

,

555

556

"

557

C

558

O

559

D

560

E

561

"

562

:

563

564

"

565

C

566

O

567

N

568

S

569

T

570

571

{

572

573

S

574

O

575

C

576

K

577

S

578

P

579

R

580

O

581

X

582

Y

583

A

584

G

585

E

586

N

587

T

588

589

}

590

591

=

592

593

R

594

E

595

Q

596

U

597

I

598

R

599

E

600

(

601

'

602

S

603

O

604

C

605

K

606

S

607

-

608

P

609

R

610

O

611

X

612

Y

613

-

614

A

615

G

616

E

617

N

618

T

619

'

620

)

621

;

622

\

623

N

624

\

625

N

626

C

627

O

628

N

629

S

630

T

631

632

A

633

G

634

E

635

N

636

T

637

638

=

639

640

N

641

E

642

W

643

644

S

645

O

646

C

647

K

648

S

649

P

650

R

651

O

652

X

653

Y

654

A

655

G

656

E

657

N

658

T

659

(

660

'

661

S

662

O

663

C

664

K

665

S

666

5

667

:

668

/

669

/

670

U

671

S

672

E

673

R

674

:

675

P

676

A

677

S

678

S

679

@

680

P

681

R

682

O

683

X

684

Y

685

.

686

G

687

P

688

R

689

O

690

X

691

Y

692

.

693

N

694

E

695

T

696

:

697

1

698

0

699

0

700

1

701

'

702

)

703

;

704

\

705

N

706

C

707

O

708

N

709

S

710

T

711

712

R

713

E

714

S

715

P

716

O

717

N

718

S

719

E

720

721

=

722

723

A

724

W

725

A

726

I

727

T

728

729

A

730

X

731

I

732

O

733

S

734

.

735

G

736

E

737

T

738

(

739

'

740

H

741

T

742

T

743

P

744

S

745

:

746

/

747

/

748

H

749

T

750

T

751

P

752

B

753

I

754

N

755

.

756

O

757

R

758

G

759

/

760

I

761

P

762

'

763

,

764

765

{

766

\

767

N

768

769

770

H

771

T

772

T

773

P

774

S

775

A

776

G

777

E

778

N

779

T

780

:

781

782

A

783

G

784

E

785

N

786

T

787

,

788

789

H

790

T

791

T

792

P

793

A

794

G

795

E

796

N

797

T

798

:

799

800

A

801

G

802

E

803

N

804

T

805

\

806

N

807

}

808

)

809

;

810

"

811

}

812

,

813

814

{

815

"

816

T

817

I

818

T

819

L

820

E

821

"

822

:

823

824

"

825

创

826

建

827

可

828

复

829

用

830

的

831

客

832

户

833

端

834

"

835

,

836

837

"

838

D

839

E

840

S

841

C

842

R

843

I

844

P

845

T

846

I

847

O

848

N

849

"

850

:

851

852

"

853

构

854

建

855

带

856

代

857

理

858

默

859

认

860

值

861

的

862

863

A

864

X

865

I

866

O

867

S

868

869

实

870

例

871

"

872

,

873

874

"

875

C

876

O

877

D

878

E

879

"

880

:

881

882

"

883

C

884

O

885

N

886

S

887

T

888

889

C

890

L

891

I

892

E

893

N

894

T

895

896

=

897

898

A

899

X

900

I

901

O

902

S

903

.

904

C

905

R

906

E

907

A

908

T

909

E

910

(

911

{

912

\

913

N

914

915

916

P

917

R

918

O

919

X

920

Y

921

:

922

923

{

924

\

925

N

926

927

928

929

930

H

931

O

932

S

933

T

934

:

935

936

'

937

P

938

R

939

O

940

X

941

Y

942

.

943

G

944

P

945

R

946

O

947

X

948

Y

949

.

950

N

951

E

952

T

953

'

954

,

955

\

956

N

957

958

959

960

961

P

962

O

963

R

964

T

965

:

966

967

1

968

0

969

0

970

0

971

,

972

\

973

N

974

975

976

977

978

A

979

U

980

T

981

H

982

:

983

984

{

985

986

U

987

S

988

E

989

R

990

N

991

A

992

M

993

E

994

:

995

996

'

997

Y

998

O

999

U

1000

R

1001

_

1002

U

1003

S

1004

E

1005

R

1006

'

1007

,

1008

1009

P

1010

A

1011

S

1012

S

1013

W

1014

O

1015

R

1016

D

1017

:

1018

1019

'

1020

Y

1021

O

1022

U

1023

R

1024

_

1025

P

1026

A

1027

S

1028

S

1029

'

1030

1031

}

1032

\

1033

N

1034

1035

1036

}

1037

,

1038

\

1039

N

1040

1041

1042

T

1043

I

1044

M

1045

E

1046

O

1047

U

1048

T

1049

:

1050

1051

3

1052

0

1053

0

1054

0

1055

0

1056

\

1057

N

1058

}

1059

)

1060

;

1061

\

1062

N

1063

\

1064

N

1065

C

1066

O

1067

N

1068

S

1069

T

1070

1071

D

1072

A

1073

T

1074

A

1075

1076

=

1077

1078

A

1079

W

1080

A

1081

I

1082

T

1083

1084

C

1085

L

1086

I

1087

E

1088

N

1089

T

1090

.

1091

G

1092

E

1093

T

1094

(

1095

'

1096

H

1097

T

1098

T

1099

P

1100

S

1101

:

1102

/

1103

/

1104

E

1105

X

1106

A

1107

M

1108

P

1109

L

1110

E

1111

.

1112

C

1113

O

1114

M

1115

'

1116

)

1117

;

1118

"

1119

}

1120

,

1121

1122

{

1123

"

1124

T

1125

I

1126

T

1127

L

1128

E

1129

"

1130

:

1131

1132

"

1133

添

1134

加

1135

重

1136

试

1137

拦

1138

截

1139

器

1140

"

1141

,

1142

1143

"

1144

D

1145

E

1146

S

1147

C

1148

R

1149

I

1150

P

1151

T

1152

I

1153

O

1154

N

1155

"

1156

:

1157

1158

"

1159

通

1160

过

1161

自

1162

动

1163

重

1164

试

1165

处

1166

理

1167

代

1168

理

1169

错

1170

误

1171

"

1172

,

1173

1174

"

1175

C

1176

O

1177

D

1178

E

1179

"

1180

:

1181

1182

"

1183

C

1184

L

1185

I

1186

E

1187

N

1188

T

1189

.

1190

I

1191

N

1192

T

1193

E

1194

R

1195

C

1196

E

1197

P

1198

T

1199

O

1200

R

1201

S

1202

.

1203

R

1204

E

1205

S

1206

P

1207

O

1208

N

1209

S

1210

E

1211

.

1212

U

1213

S

1214

E

1215

(

1216

\

1217

N

1218

1219

1220

R

1221

E

1222

S

1223

P

1224

O

1225

N

1226

S

1227

E

1228

1229

=

1230

>

1231

1232

R

1233

E

1234

S

1235

P

1236

O

1237

N

1238

S

1239

E

1240

,

1241

\

1242

N

1243

1244

1245

A

1246

S

1247

Y

1248

N

1249

C

1250

1251

E

1252

R

1253

R

1254

O

1255

R

1256

1257

=

1258

>

1259

1260

{

1261

\

1262

N

1263

1264

1265

1266

1267

I

1268

F

1269

1270

(

1271

E

1272

R

1273

R

1274

O

1275

R

1276

.

1277

R

1278

E

1279

S

1280

P

1281

O

1282

N

1283

S

1284

E

1285

?

1286

.

1287

S

1288

T

1289

A

1290

T

1291

U

1292

S

1293

1294

=

1295

=

1296

=

1297

1298

4

1299

0

1300

7

1301

1302

|

1303

|

1304

1305

E

1306

R

1307

R

1308

O

1309

R

1310

.

1311

C

1312

O

1313

D

1314

E

1315

1316

=

1317

=

1318

=

1319

1320

'

1321

E

1322

C

1323

O

1324

N

1325

N

1326

R

1327

E

1328

S

1329

E

1330

T

1331

'

1332

)

1333

1334

{

1335

\

1336

N

1337

1338

1339

1340

1341

1342

1343

R

1344

E

1345

T

1346

U

1347

R

1348

N

1349

1350

C

1351

L

1352

I

1353

E

1354

N

1355

T

1356

.

1357

R

1358

E

1359

Q

1360

U

1361

E

1362

S

1363

T

1364

(

1365

E

1366

R

1367

R

1368

O

1369

R

1370

.

1371

C

1372

O

1373

N

1374

F

1375

I

1376

G

1377

)

1378

;

1379

1380

/

1381

/

1382

1383

重

1384

试

1385

\

1386

N

1387

1388

1389

1390

1391

}

1392

\

1393

N

1394

1395

1396

1397

1398

T

1399

H

1400

R

1401

O

1402

W

1403

1404

E

1405

R

1406

R

1407

O

1408

R

1409

;

1410

\

1411

N

1412

1413

1414

}

1415

\

1416

N

1417

)

1418

;

1419

"

1420

}

1421

,

1422

1423

{

1424

"

1425

T

1426

I

1427

T

1428

L

1429

E

1430

"

1431

:

1432

1433

"

1434

测

1435

试

1436

配

1437

置

1438

"

1439

,

1440

1441

"

1442

D

1443

E

1444

S

1445

C

1446

R

1447

I

1448

P

1449

T

1450

I

1451

O

1452

N

1453

"

1454

:

1455

1456

"

1457

验

1458

证

1459

代

1460

理

1461

是

1462

否

1463

正

1464

确

1465

路

1466

由

1467

"

1468

,

1469

1470

"

1471

C

1472

O

1473

D

1474

E

1475

"

1476

:

1477

1478

"

1479

C

1480

O

1481

N

1482

S

1483

T

1484

1485

R

1486

E

1487

S

1488

1489

=

1490

1491

A

1492

W

1493

A

1494

I

1495

T

1496

1497

C

1498

L

1499

I

1500

E

1501

N

1502

T

1503

.

1504

G

1505

E

1506

T

1507

(

1508

'

1509

H

1510

T

1511

T

1512

P

1513

S

1514

:

1515

/

1516

/

1517

H

1518

T

1519

T

1520

P

1521

B

1522

I

1523

N

1524

.

1525

O

1526

R

1527

G

1528

/

1529

I

1530

P

1531

'

1532

)

1533

;

1534

\

1535

N

1536

C

1537

O

1538

N

1539

S

1540

O

1541

L

1542

E

1543

.

1544

L

1545

O

1546

G

1547

(

1548

'

1549

P

1550

R

1551

O

1552

X

1553

Y

1554

1555

I

1556

P

1557

:

1558

'

1559

,

1560

1561

R

1562

E

1563

S

1564

.

1565

D

1566

A

1567

T

1568

A

1569

.

1570

O

1571

R

1572

I

1573

G

1574

I

1575

N

1576

)

1577

;

1578

"

1579

}

1580

]

代码示例

为什么要在 Axios 中使用代理？

Axios 是 Node.js 和浏览器中最流行的 HTTP 客户端，npm 每周下载量超过 1 亿次。为 Axios 添加 GProxy 代理，可以实现用于网页抓取的 IP 轮换、从不同地区访问 API 以及匿名处理请求。GProxy 的 10M+ 住宅 IP 和 150+ 国家覆盖可与 Axios 的代理配置无缝集成。

基本代理配置

Axios 通过内置的 proxy 配置项支持 HTTP 代理。直接在请求配置中或作为默认值传入代理主机、端口和认证凭据。通过 HTTP 代理访问 HTTPS 目标时，Axios 会自动处理 CONNECT 隧道。

SOCKS5 代理支持

Axios 本身不支持 SOCKS5，但您可以通过 socks-proxy-agent 包添加支持。创建一个 SOCKS5 agent，并在 Axios 配置中作为 httpsAgent 传入。这与 GProxy 的 SOCKS5 端点兼容。

用于代理逻辑的请求拦截器

Axios 拦截器可用于添加代理轮换逻辑、失败重试和日志记录。添加请求拦截器以动态分配代理，添加响应拦截器以处理代理错误并换用其他 IP 重试。

并发请求

Node.js 的异步特性非常适合并发的代理请求。使用 Promise.all() 或 p-limit 控制并发量。通过 GProxy 的 backconnect 端点发出的每个请求都会获得唯一 IP，因此并发请求天然实现轮换。

错误处理最佳实践

代理相关的错误需要特殊处理：407 表示认证失败，ECONNREFUSED 表示无法连接到代理，ETIMEDOUT 表示代理或目标响应缓慢。设置合理的超时时间，并实现带指数退避的重试逻辑，以保证生产环境的可靠性。

应用场景

[

{

"

T

I

T

L

E

"

:

"

A

P

I

数

据

采

集

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

使

用

轮

换

代

理

从

按

I

P

限

流

的

A

P

I

中

采

集

数

据

。

"

}

,

{

"

T

I

T

L

E

"

:

"

价

格

监

控

服

务

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

构

建

从

不

同

地

区

查

询

零

售

商

的

价

格

跟

踪

微

服

务

。

"

}

,

{

"

T

I

T

L

E

"

:

"

W

E

B

H

O

K

测

试

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

从

不

同

I

P

发

送

测

试

W

E

B

H

O

K

，

以

验

证

应

用

的

安

全

过

滤

规

则

。

"

}

,

{

"

T

I

T

L

E

"

:

"

微

服

务

测

试

"

,

"

D

E

S

C

R

I

P

T

I

O

N

"

:

"

从

外

部

I

P

测

试

自

己

的

A

P

I

，

以

验

证

限

流

和

地

理

封

锁

规

则

。

"

}

]

进阶技巧

为保持代码整洁，创建一个带代理默认配置的专用 Axios 实例。使用 p-limit 控制并发量，避免压垮目标服务器。添加响应拦截器，在代理出错时自动重试。设置合理的超时时间（30 秒），从容应对较慢的代理连接。

FAQ

准备开始了吗？

几分钟即可开始使用 GProxy——住宅代理 $0.85/GB 起，IPv6 $0.03/个起，按用量付费。

创建账户 → 套餐

其他集成

GProxy + Scrapy

了解如何为大规模网页抓取配置 GProxy 住宅代理和数据中心代理与 Scrapy 配合使用，内容涵盖中间件设置、代理轮换和错误处理。

GProxy + cURL

在命令行 HTTP 请求中使用 GProxy 代理与 cURL。涵盖 HTTP、HTTPS、SOCKS5 代理类型、身份验证以及高级选项。

GProxy + Postman

在 Postman 中配置 GProxy 代理，从不同位置测试 API。涵盖全局代理设置、按请求配置以及环境变量。

GProxy + n8n

把 n8n 工作流的 HTTP 请求通过 GProxy 代理转发。涵盖 HTTP Request 节点配置、环境变量和自动化模式。

GProxy + Apify

为 Apify actor 配置 GProxy 住宅代理和数据中心代理，用于网页抓取。涵盖代理配置、Crawlee 集成与成本优化。

GProxy + Puppeteer

为无头 Chrome 自动化配置 GProxy 代理，涵盖代理认证、按页面切换代理和 stealth 技术。