Repository navigation
Expand file tree
/
Copy pathrss.xml
More file actions
2725 lines (2725 loc) · 439 KB
/
Copy pathrss.xml
File metadata and controls
2725 lines (2725 loc) · 439 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?xml version="1.0" encoding="utf-8"?><rss xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title>ALEXCDEVER's Blog</title><link>https://blog.alexc.cn/</link><description>喜欢各种瞎折腾</description><generator>Hugo 0.167.0 https://gohugo.io/</generator><language>zh-CN</language><managingEditor>alexcdever@gmail.com (Alex Chen)</managingEditor><webMaster>alexcdever@gmail.com (Alex Chen)</webMaster><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><lastBuildDate>Mon, 02 Nov 2026 01:49:20 +0000</lastBuildDate><atom:link rel="self" type="application/rss+xml" href="https://blog.alexc.cn/rss.xml"/><item><title>
我的 pipeline 技能:一份给 AI 看的编程流程契约</title><link>https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/</guid><pubDate>Mon, 02 Nov 2026 03:59:14 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<p><code>pipeline</code> 是我写的一份纯流程契约:<strong>不绑定任何具体的 agent 软件</strong>——它规定主代理、执行子代理、审查子代理在做编程任务时怎么协作,什么算完成、什么不算。没有脚本、没有工具、没有运行时,只有一份 <code>SKILL.md</code> 契约、一份术语表、一份残留恢复手册。仓库在 GitHub:<a href="https://github.com/alexcdever/pipeline" target="_blank" rel="noopener">alexcdever/pipeline</a>。</p>
<p>写它的起因很朴素:单次大模型调用写代码,要么上下文爆了,要么写完没人验,要么改完把别处弄坏了没人发现。我想要的不是「让 AI 写代码更快」,而是「让 AI 写代码<strong>更有效率</strong>」——更重要的是降低我自己的决策成本:能自己判断的自己判断,能自己收拾的自己收拾,人只在真正需要裁决的地方出现。</p>
<h2 id="核心结构三个人--一个-worktree"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#核心结构三个人--一个-worktree" class="anchor-link" aria-label="核心结构三个人--一个-worktree"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:核心结构三个人--一个-worktree" class="headings">核心结构:三个人 + 一个 worktree</a></h2>
<p>这套流程的开销<strong>按任务计,不按改动大小计</strong>。每个任务的最小开销是:预走一遍验收标准、派执行者与审查者各一个独立子代理、建一个 Git worktree、留四个文件、跑一次合并后复验,外加<strong>三次全量测试</strong>——<strong>改动只有三行,这七步也一步不能省</strong>。</p>
<ul>
<li><strong>主代理</strong>:面向用户,决定做什么、什么算完成。规划、写任务描述、派发、核对、合并。<strong>自己不改产品代码</strong>。</li>
<li><strong>执行子代理</strong>:在隔离 worktree 里实现,遵循测试驱动——先红、最小实现、重构。</li>
<li><strong>审查子代理</strong>:在独立上下文里亲手复验,不采信任何转述,只看代码、测试和自己跑出来的结果——包括自己再跑一次全量测试。</li>
</ul>
<p>三个角色绕着一个 worktree 走七步:摸底 → 建 worktree → 写任务描述 → 派执行 → 派审查 → 合并 → 清场。中间每一步都有明确的「什么算证据」——退出码为 0 不算验收,必须检查实际状态变化;<code>task.md</code> 里写的范围是白名单,不在里面的改动算越界;审查者先写自己的结论,再读执行者留下的东西对照。</p>
<h2 id="几个踩过坑后写下的规则"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#几个踩过坑后写下的规则" class="anchor-link" aria-label="几个踩过坑后写下的规则"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:几个踩过坑后写下的规则" class="headings">几个踩过坑后写下的规则</a></h2>
<p>这份契约里大部分条款都是踩过一次坑之后才加上的。挑四条:</p>
<h3 id="子代理说做完了不代表活真的干完了"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#子代理说做完了不代表活真的干完了" class="anchor-link" aria-label="子代理说做完了不代表活真的干完了"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:子代理说做完了不代表活真的干完了" class="headings">子代理说「做完了」,不代表活真的干完了</a></h3>
<p>有一次执行者回报完成,实际上一个提交都没有——它的上下文全花在翻代码、找文件上了。这种回报既不算「执行失败」,也不能直接送去审查:审查者只能对着一份空 diff 白跑一轮。正确的做法是就地重派,但必须把这一轮它已经探明的事实(数据在哪、函数叫什么、口径怎么定)一并写进新的派发材料,让它从写测试开始,而不是从头再探一遍。</p>
<h3 id="任务队列不能只活在对话里"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#任务队列不能只活在对话里" class="anchor-link" aria-label="任务队列不能只活在对话里"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:任务队列不能只活在对话里" class="headings">任务队列不能只活在对话里</a></h3>
<p>队列以前只存在主代理的会话记录里。会话一旦被压缩、或者换一个 agent 接手,队列就没了——而 worktree 和分支还在,没人知道还剩几个任务没做。现在一份在会话里当读写入口,一份落在仓库的 <code>.git</code> 目录里(<code>pipeline/queue.md</code>)当恢复入口,两处对不上以磁盘那份为准。这是把「计算和状态分开」的思路搬进自己的流程:会话是随时可丢的计算,队列是必须留下的状态。</p>
<h3 id="派发材料要分层写"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#派发材料要分层写" class="anchor-link" aria-label="派发材料要分层写"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:派发材料要分层写" class="headings">派发材料要分层写</a></h3>
<p>主代理交代给执行者的材料,不是越多越好,也不是越少越好。分三层:执行者不拿到就得自己重新发现的事实(数据位置、函数名、示例行号),主代理要直接写进材料里,别指望它自己去翻;它能自己读的给路径指针;只在需要时才看的给入口。漏了第一层的,它会自己发明一套方法去探——这就是上下文被探索吃光的原因。</p>
<h3 id="大仓库检出-worktree-必须放后台跑"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#大仓库检出-worktree-必须放后台跑" class="anchor-link" aria-label="大仓库检出-worktree-必须放后台跑"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:大仓库检出-worktree-必须放后台跑" class="headings">大仓库检出 worktree 必须放后台跑</a></h3>
<p>十几万文件的素材仓,跑 <code>git worktree add</code> 一次检出的耗时一定超过命令工具的前台超时——必被杀,留下一个半截的检出结果:文件数只有一半、<code>index.lock</code> 残留,但 <code>git status</code> 偏偏报「0 个缺失」——这个假象最坑人,会让你以为检出结果是完整的。判断办法是三个特征一起看:文件数远少于预期、<code>status</code> 报 0 缺失、关键路径不存在。三条同时成立就说明这棵树救不回来,清掉重建,别在半截上补跑。</p>
<h2 id="从-deepseek-的-super-agent-借了什么"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#从-deepseek-的-super-agent-借了什么" class="anchor-link" aria-label="从-deepseek-的-super-agent-借了什么"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:从-deepseek-的-super-agent-借了什么" class="headings">从 DeepSeek 的 Super-agent 借了什么</a></h2>
<p>前两天看到 DeepSeek Harness 团队发的《Super-agent 设计探索:迈向更自主的 Agent 系统》(<a href="https://github.com/deepseek-ai/dsh-superagent-prototype" target="_blank" rel="noopener">GitHub</a>),对照之下我吸了四点:</p>
<ol>
<li><strong>主代理把任务队列从一份改成两份</strong>——对应它的「计算与状态分离」:一份留在会话里当读写入口,一份落在仓库 <code>.git</code> 目录里(<code>pipeline/queue.md</code>)当恢复入口,会话被压缩或换 agent 接手时状态还能找回。</li>
<li><strong>主代理派发时写下两条判断标准和一个时限</strong>——对应它的 Watchdog:不再干等回报,主代理只看 <code>git log</code> 的提交数和 <code>progress.md</code> 的修改时间这两个确定性信号;超了时限先判断执行者是不是卡住,不是继续等。</li>
<li><strong>主代理把派发材料分三层写</strong>——对应它的 Inline &amp; Spill:执行者不拿到就得自己重新发现的事实直接写进材料,它能自己读的给路径指针,只在需要时才看的给入口;漏了第一层,它会自己发明一套方法去探。</li>
<li><strong>主代理向在跑的执行者追加输入</strong>——对应它的订阅直通:同一份描述下的裁决直接送回在跑的执行者,不换来一次完整的重派和还原(宿主支持时)。</li>
</ol>
<p>但也有刻意没搬的:<strong>投机执行</strong>(我的原则是子代理只在我明确派了活之后才动手,不能在我还不确定时就在后台预做);<strong>Router 批处理</strong>(DeepSeek 的 Router 能攒批,是因为它处理的是中立的环境事件流;我这里的「回报」是子代理各自承载判断责任交回来的结论,必须逐一核对,不是能让你攒批的原始输入);<strong>Session 对用户隐藏</strong>(我的四个文件恰恰是把会话结构显式化给审查者看的审计面,隐藏它等于拆掉制衡)。</p>
<p>那篇文章的核心判断——「单任务上限取决于模型能力,多任务上限取决于人的注意力,一个人通常只能同时跟进 3 到 5 个活跃 Session」——和我的「在跑任务不超过三个」是同一个观察的另一种量化。有外部依据了。</p>
<h2 id="这东西不适合谁"><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#这东西不适合谁" class="anchor-link" aria-label="这东西不适合谁"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E6%88%91%E7%9A%84pipeline%E6%8A%80%E8%83%BD%E4%B8%80%E4%BB%BD%E7%BB%99ai%E7%9C%8B%E7%9A%84%E7%BC%96%E7%A8%8B%E6%B5%81%E7%A8%8B%E5%A5%91%E7%BA%A6/#contents:这东西不适合谁" class="headings">这东西不适合谁</a></h2>
<p>契约开头就写了硬前提:<strong>宿主必须能派发具备独立上下文的子代理,并且能读写项目文件、运行命令、用 Git worktree。</strong> 做不到这些,这个技能不适用——它没有降级模式,同一个上下文既实现又审查是不允许的。</p>
<p>它的<strong>开销不随改动缩小</strong>:小到 agent 几分钟能写完、自己一眼能验完的活,用它的成本大于收益;全量测试跑十几分钟、又没有更快分层办法的项目,也要重新掂量。</p></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/agent/">Agent</category><category domain="https://blog.alexc.cn/tags/workflow/">Workflow</category><category domain="https://blog.alexc.cn/tags/llm/">Llm</category><category domain="https://blog.alexc.cn/tags/git/">Git</category><category domain="https://blog.alexc.cn/tags/subagent/">Subagent</category></item><item><title>
【已失效】管理远程k3s集群</title><link>https://blog.alexc.cn/posts/%E7%AE%A1%E7%90%86%E8%BF%9C%E7%A8%8Bk3s%E9%9B%86%E7%BE%A4/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E7%AE%A1%E7%90%86%E8%BF%9C%E7%A8%8Bk3s%E9%9B%86%E7%BE%A4/</guid><pubDate>Thu, 17 Feb 2022 22:57:45 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>本文依赖的远程 k3s 集群、kubeconfig 和当时的服务器环境已经不存在,文中的操作无法直接复现,也不构成当前 k3s 集群管理指南。本文正文仅保留作历史参考。</p>
</blockquote>
<del>
<ol>
<li>
<p>安装 <strong>kubectl</strong></p>
<ol>
<li>macOS 可通过 homebrew 安装:<code>brew install kubernetes-cli</code></li>
</ol>
</li>
<li>
<p>登录进入 <strong>k3s</strong> 集群的 <strong>master</strong> 节点所在的机器,并找到 <code>/etc/rancher/k3s/k3s.yaml</code>,这份文件就是 <strong>kubeconfig</strong> 了,跟本地的<code>~/.kube/config</code>是同一个东西,接下来可以直接替换掉本地的<strong>config</strong>,也可以把<strong>k3s.yaml</strong>里的<strong>server</strong>、<strong>context</strong>和<strong>user</strong>加进config,并把<strong>current-context</strong>改成<strong>k3s</strong>的<strong>context</strong></p>
</li>
<li>
<p>用<code>kubectl cluster-info</code>去验证能否正常使用</p>
</li>
</ol>
</del></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/k3s/">K3s</category><category domain="https://blog.alexc.cn/tags/kubectl/">Kubectl</category><category domain="https://blog.alexc.cn/tags/kubernetes/">Kubernetes</category></item><item><title>
将gitlab-runner部署到k3s集群中</title><link>https://blog.alexc.cn/posts/%E5%B0%86gitlab-runner%E9%83%A8%E7%BD%B2%E5%88%B0k3s%E9%9B%86%E7%BE%A4%E4%B8%AD/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E5%B0%86gitlab-runner%E9%83%A8%E7%BD%B2%E5%88%B0k3s%E9%9B%86%E7%BE%A4%E4%B8%AD/</guid><pubDate>Thu, 17 Feb 2022 22:57:45 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>更新于 2026-10:GitLab 17 之后 runner 的注册方式改成了「认证令牌(runnerToken)」,旧的 registration token 已弃用;文档地址、values.yaml 的键名和 dind 镜像一并更新。</p>
</blockquote>
<p>参考资料:</p>
<ul>
<li><a href="https://docs.gitlab.com/runner/install/kubernetes.html" target="_blank" rel="noopener">GitLab Runner Helm chart | GitLab Docs</a></li>
<li><a href="https://docs.gitlab.com/ci/docker/docker_in_docker/" target="_blank" rel="noopener">Use Docker-in-Docker | GitLab Docs</a></li>
<li><a href="https://docs.gitlab.com/ci/docker/using_docker_build/" target="_blank" rel="noopener">Use Docker to build Docker images | GitLab Docs</a></li>
</ul>
<ol>
<li>
<p>安装helm</p>
<ul>
<li>macOS下可通过homebrew安装</li>
<li><code>brew install helm</code></li>
</ul>
</li>
<li>
<p>添加gitlab的chart库</p>
<ul>
<li><code>helm repo add gitlab https://charts.gitlab.io</code></li>
<li><code>helm repo update gitlab</code></li>
</ul>
</li>
<li>
<p>创建并编辑values.yaml</p>
<ol>
<li>
<p>复制官方提供的示例文件:<a href="https://gitlab.com/gitlab-org/charts/gitlab-runner/-/blob/main/values.yaml" target="_blank" rel="noopener">values.yaml · main · GitLab.org / charts / GitLab Runner</a></p>
</li>
<li>
<p>至少要配上这几项:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span><span class="lnt">16
</span><span class="lnt">17
</span><span class="lnt">18
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">gitlabUrl</span><span class="p">:</span><span class="w"> </span><span class="l">https://gitlab.example.com/</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># 在 GitLab 的 项目/群组 → Settings → CI/CD → Runners → New project runner 里创建后拿到的认证令牌</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">runnerToken</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;glrt-xxxxxxxxxxxxxxxxxxxx&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">rbac</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">create</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">runners</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">tags</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;k3s&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">config</span><span class="p">:</span><span class="w"> </span><span class="p">|</span><span class="sd">
</span></span></span><span class="line"><span class="cl"><span class="sd"> [[runners]]
</span></span></span><span class="line"><span class="cl"><span class="sd"> [runners.kubernetes]
</span></span></span><span class="line"><span class="cl"><span class="sd"> namespace = &#34;{{.Release.Namespace}}&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd"> image = &#34;ubuntu:24.04&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd"> privileged = true
</span></span></span><span class="line"><span class="cl"><span class="sd"> # 如果要想在runner里构建docker镜像,就要加入以下配置,因为docker的dind镜像自19.03开始就默认使用tls端口
</span></span></span><span class="line"><span class="cl"><span class="sd"> [[runners.kubernetes.volumes.empty_dir]]
</span></span></span><span class="line"><span class="cl"><span class="sd"> name = &#34;docker-certs&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd"> mount_path = &#34;/certs/client&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd"> medium = &#34;Memory&#34;</span><span class="w">
</span></span></span></code></pre></td></tr></table></div>
</div>
</div><p>注意 <code>runnerToken</code> 不要提交到仓库,用 <code>--set</code> 或者加密后的 Secret 注入。</p>
</li>
<li>
<p>其他的配置项按需配置即可</p>
</li>
</ol>
</li>
<li>
<p>将gitlab runner部署到k3s</p>
<p><code>helm install --namespace {namespace} gitlab-runner -f {path to values.yaml} gitlab/gitlab-runner</code></p>
</li>
<li>
<p>验证</p>
<p><code>kubectl -n {namespace} get pods</code> 看到 runner 的 pod 处于 Running,再到 GitLab 的 Runners 页面确认状态是绿色即可。</p>
</li>
</ol>
<h2 id="额外提醒"><a href="https://blog.alexc.cn/posts/%E5%B0%86gitlab-runner%E9%83%A8%E7%BD%B2%E5%88%B0k3s%E9%9B%86%E7%BE%A4%E4%B8%AD/#额外提醒" class="anchor-link" aria-label="额外提醒"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%B0%86gitlab-runner%E9%83%A8%E7%BD%B2%E5%88%B0k3s%E9%9B%86%E7%BE%A4%E4%B8%AD/#contents:额外提醒" class="headings">额外提醒</a></h2>
<p>假如要使用runner构建docker镜像,请在<code>.gitlab-ci.yml</code>里加入以下内容(镜像记得锁具体版本,用 <code>latest</code> 会随机炸):</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">default</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">docker:28-cli</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">services</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">docker:28-dind</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">variables</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># dind 场景下要让 docker 客户端去连 service 容器里那个 daemon, 而不是默认的 /var/run/docker.sock</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">DOCKER_HOST</span><span class="p">:</span><span class="w"> </span><span class="l">tcp://docker:2376</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># 证书目录, dind 从 19.03 起默认开启 TLS</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">DOCKER_TLS_CERTDIR</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;/certs&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># Kubernetes executor 不会执行镜像的 entrypoint, 这两个变量要自己声明</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">DOCKER_TLS_VERIFY</span><span class="p">:</span><span class="w"> </span><span class="m">1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">DOCKER_CERT_PATH</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;$DOCKER_TLS_CERTDIR/client&#34;</span><span class="w">
</span></span></span></code></pre></td></tr></table></div>
</div>
</div><p>k3s 侧还有两点:一是 runner 的 job pod 需要 <code>privileged</code>,k3s 默认不拦,这一点和标准 k8s 集群(默认 PodSecurity 会拦)不同;二是 k3s 自带 <code>local-path</code> 这个 storageClass,job 里要持久化缓存可以直接用。</p></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/gitlab-runner/">Gitlab Runner</category><category domain="https://blog.alexc.cn/tags/gitlab-ci/">Gitlab-Ci</category><category domain="https://blog.alexc.cn/tags/k3s/">K3s</category><category domain="https://blog.alexc.cn/tags/helm/">Helm</category><category domain="https://blog.alexc.cn/tags/gitlab/">Gitlab</category><category domain="https://blog.alexc.cn/tags/kubernetes/">Kubernetes</category></item><item><title>
Ubuntu系统搭建开发环境</title><link>https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/</guid><pubDate>Sat, 16 Oct 2021 03:22:38 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>更新于 2026-10:这是一份「新机器从上电到能开发」的顺序清单,每个工具的详细说明在<a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/" target="_blank" rel="noopener">我的开发环境之Linux篇</a>里。原文里失效的几条(get.daocloud.io 一键脚本、Linuxbrew 仓库、raw.github.com 域名)已经替换。</p>
</blockquote>
<p>以 Ubuntu 22.04 / 24.04 为例。</p>
<h2 id="1-换成国内镜像源"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#1-换成国内镜像源" class="anchor-link" aria-label="1-换成国内镜像源"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:1-换成国内镜像源" class="headings">1. 换成国内镜像源</a></h2>
<p>清华、阿里云、中科大等机构都提供 Ubuntu 镜像源。</p>
<ul>
<li>
<p>22.04 及更早,源列表在 <code>/etc/apt/sources.list</code>:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo sed -i <span class="s1">&#39;s|http://archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g; s|http://security.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g&#39;</span> /etc/apt/sources.list
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>24.04 起改用 deb822 格式,源列表在 <code>/etc/apt/sources.list.d/ubuntu.sources</code>,同样的替换:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo sed -i <span class="s1">&#39;s|http://archive.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g; s|http://security.ubuntu.com|https://mirrors.tuna.tsinghua.edu.cn|g&#39;</span> /etc/apt/sources.list.d/ubuntu.sources
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>改完更新索引:<code>sudo apt update</code></p>
</li>
</ul>
<h2 id="2-创建-ssh-密钥"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#2-创建-ssh-密钥" class="anchor-link" aria-label="2-创建-ssh-密钥"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:2-创建-ssh-密钥" class="headings">2. 创建 ssh 密钥</a></h2>
<p><code>ssh-keygen -t ed25519</code> 然后一路回车,公钥在 <code>~/.ssh/id_ed25519.pub</code>,把它贴到需要的地方即可。</p>
<h2 id="3-安装常用的工具"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#3-安装常用的工具" class="anchor-link" aria-label="3-安装常用的工具"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:3-安装常用的工具" class="headings">3. 安装常用的工具</a></h2>
<p><code>sudo apt install curl git vim zip autofs cifs-utils net-tools build-essential file -y</code></p>
<h2 id="4-更新并升级系统内的组件和工具"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#4-更新并升级系统内的组件和工具" class="anchor-link" aria-label="4-更新并升级系统内的组件和工具"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:4-更新并升级系统内的组件和工具" class="headings">4. 更新并升级系统内的组件和工具</a></h2>
<p><code>sudo apt update &amp;&amp; sudo apt upgrade -y &amp;&amp; sudo apt autoremove -y &amp;&amp; sudo apt autoclean -y</code></p>
<h2 id="5-oh-my-zsh-和-zsh"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#5-oh-my-zsh-和-zsh" class="anchor-link" aria-label="5-oh-my-zsh-和-zsh"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:5-oh-my-zsh-和-zsh" class="headings">5. oh-my-zsh 和 zsh</a></h2>
<ol>
<li>
<p><code>sudo apt install zsh -y</code></p>
</li>
<li>
<p><code>sh -c &quot;$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)&quot;</code>(原文的 <code>raw.github.com</code> 已不推荐)</p>
</li>
<li>
<p>装插件:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">git clone https://github.com/zsh-users/zsh-autosuggestions <span class="si">${</span><span class="nv">ZSH_CUSTOM</span><span class="k">:-</span><span class="nv">$HOME</span><span class="p">/.oh-my-zsh/custom</span><span class="si">}</span>/plugins/zsh-autosuggestions
</span></span><span class="line"><span class="cl">git clone https://github.com/zsh-users/zsh-syntax-highlighting <span class="si">${</span><span class="nv">ZSH_CUSTOM</span><span class="k">:-</span><span class="nv">$HOME</span><span class="p">/.oh-my-zsh/custom</span><span class="si">}</span>/plugins/zsh-syntax-highlighting
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>修改 <code>.zshrc</code>,把 <code>zsh-autosuggestions</code> 和 <code>zsh-syntax-highlighting</code> 加到 <code>plugins</code> 数组里</p>
</li>
</ol>
<h2 id="6-docker"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#6-docker" class="anchor-link" aria-label="6-docker"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:6-docker" class="headings">6. docker</a></h2>
<p>原文的一键脚本<strong>都不要再用了</strong>:</p>
<ul>
<li><code>curl -sSL https://get.daocloud.io/docker | sh</code> —— DaoCloud 的这个安装脚本服务早已停止(域名还能解析,但连不上)</li>
<li><code>curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun</code> —— 一键脚本官方只推荐用于测试环境,而且 <code>--mirror Aliyun</code> 指向的公共加速器在 2024 年已经关停</li>
</ul>
<p>正式一点的装法(官方 apt 仓库 + keyring),步骤见<a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/" target="_blank" rel="noopener">我的开发环境之Linux篇</a>;国内拉镜像的现状那里也一并写了。</p>
<h2 id="7-homebrew原-linuxbrew"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#7-homebrew原-linuxbrew" class="anchor-link" aria-label="7-homebrew原-linuxbrew"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:7-homebrew原-linuxbrew" class="headings">7. Homebrew(原 linuxbrew)</a></h2>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span><span class="lnt">3
</span><span class="lnt">4
</span><span class="lnt">5
</span><span class="lnt">6
</span><span class="lnt">7
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="c1"># 依赖</span>
</span></span><span class="line"><span class="cl">sudo apt install build-essential procps curl file git -y
</span></span><span class="line"><span class="cl"><span class="c1"># 安装(Linuxbrew 的两个仓库都已归档,安装脚本从 Homebrew 官方仓库取)</span>
</span></span><span class="line"><span class="cl">/bin/bash -c <span class="s2">&#34;</span><span class="k">$(</span>curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh<span class="k">)</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl"><span class="c1"># 加入 PATH</span>
</span></span><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s1">&#39;eval &#34;$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)&#34;&#39;</span> &gt;&gt; ~/.zshrc
</span></span><span class="line"><span class="cl"><span class="nb">eval</span> <span class="s2">&#34;</span><span class="k">$(</span>/home/linuxbrew/.linuxbrew/bin/brew shellenv<span class="k">)</span><span class="s2">&#34;</span>
</span></span></code></pre></td></tr></table></div>
</div>
</div><h2 id="8-sdkman"><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#8-sdkman" class="anchor-link" aria-label="8-sdkman"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E7%B3%BB%E7%BB%9F%E6%90%AD%E5%BB%BA%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/#contents:8-sdkman" class="headings">8. sdkman</a></h2>
<p><code>curl -s &quot;https://get.sdkman.io&quot; | bash</code>,装完执行 <code>source &quot;$HOME/.sdkman/bin/sdkman-init.sh&quot;</code> 或新开一个终端。</p></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/linux/">Linux</category><category domain="https://blog.alexc.cn/tags/ubuntu/">Ubuntu</category><category domain="https://blog.alexc.cn/tags/apt/">Apt</category><category domain="https://blog.alexc.cn/tags/ssh/">Ssh</category><category domain="https://blog.alexc.cn/tags/zsh/">Zsh</category><category domain="https://blog.alexc.cn/tags/oh-my-zsh/">Oh-My-Zsh</category><category domain="https://blog.alexc.cn/tags/docker/">Docker</category><category domain="https://blog.alexc.cn/tags/linuxbrew/">Linuxbrew</category><category domain="https://blog.alexc.cn/tags/sdkman/">Sdkman</category></item><item><title>
MacOS修改鼠标移速</title><link>https://blog.alexc.cn/posts/macos%E4%BF%AE%E6%94%B9%E9%BC%A0%E6%A0%87%E7%A7%BB%E9%80%9F/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/macos%E4%BF%AE%E6%94%B9%E9%BC%A0%E6%A0%87%E7%A7%BB%E9%80%9F/</guid><pubDate>Sat, 12 Jun 2021 00:34:26 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<ol>
<li>先查看当前速度:
<ul>
<li>鼠标双击阈值:<code>defaults read -g com.apple.mouse.doubleClickThreshold</code></li>
<li>鼠标加速度(即本次我想要改的鼠标移动速度):<code>defaults read -g com.apple.mouse.scaling</code></li>
<li>鼠标滚轮速度:<code>defaults read -g com.apple.scrollwheel.scaling</code></li>
</ul>
</li>
<li>修改对应的速度
<ul>
<li><code>defaults write -g com.apple.mouse.doubleClickThreshold 0.75</code></li>
<li><code>defaults write -g com.apple.mouse.scaling 11</code></li>
<li><code>defaults write -g com.apple.scrollwheel.scaling 0.75</code></li>
</ul>
</li>
</ol></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/macos/">MacOS</category><category domain="https://blog.alexc.cn/tags/%E9%BC%A0%E6%A0%87/">鼠标</category><category domain="https://blog.alexc.cn/tags/%E7%A7%BB%E5%8A%A8%E9%80%9F%E5%BA%A6/">移动速度</category></item><item><title>
Ubuntu挂载trueNAS共享的samba</title><link>https://blog.alexc.cn/posts/ubuntu%E6%8C%82%E8%BD%BDtruenas%E5%85%B1%E4%BA%AB%E7%9A%84samba/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/ubuntu%E6%8C%82%E8%BD%BDtruenas%E5%85%B1%E4%BA%AB%E7%9A%84samba/</guid><pubDate>Sat, 12 Jun 2021 00:23:14 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<p><em>温馨提示:需要安装cifs-utils</em></p>
<p>参考链接:<a href="https://www.jianshu.com/p/f4ec8a960f01" target="_blank" rel="noopener">Ubuntu 18.04 开机自动挂载NAS</a></p>
<h2 id="临时挂载"><a href="https://blog.alexc.cn/posts/ubuntu%E6%8C%82%E8%BD%BDtruenas%E5%85%B1%E4%BA%AB%E7%9A%84samba/#临时挂载" class="anchor-link" aria-label="临时挂载"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E6%8C%82%E8%BD%BDtruenas%E5%85%B1%E4%BA%AB%E7%9A%84samba/#contents:临时挂载" class="headings">临时挂载</a></h2>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo mount -t cifs -o <span class="nv">user</span><span class="o">={</span>username<span class="o">}</span>,password<span class="o">={</span>password<span class="o">}</span> //<span class="o">{</span>NAS的主机名或IP<span class="o">}</span>/<span class="o">{</span>共享名<span class="o">}</span> /mnt/nas/
</span></span></code></pre></td></tr></table></div>
</div>
</div><h2 id="使用autofs进行自动挂载"><a href="https://blog.alexc.cn/posts/ubuntu%E6%8C%82%E8%BD%BDtruenas%E5%85%B1%E4%BA%AB%E7%9A%84samba/#使用autofs进行自动挂载" class="anchor-link" aria-label="使用autofs进行自动挂载"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu%E6%8C%82%E8%BD%BDtruenas%E5%85%B1%E4%BA%AB%E7%9A%84samba/#contents:使用autofs进行自动挂载" class="headings">使用autofs进行自动挂载</a></h2>
<ol>
<li>
<p>安装autofs:<code>sudo apt install autofs -y</code></p>
</li>
<li>
<p>编辑<code>/etc/auto.master</code>,添加<code>/mnt /etc/auto.misc</code> 。前者表示远程目录被挂载的父目录,后者表示要被应用的挂载配置文件</p>
</li>
<li>
<p>创建一个记录了账号密码的文件,内里要记录的内容为:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nv">username</span><span class="o">=</span>xxx
</span></span><span class="line"><span class="cl"><span class="nv">password</span><span class="o">=</span>xxx
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>编辑<code>/etc/auto.misc</code> ,添加<code>nas -fstype=cifs,credentials=/home/alex/credential.txt,uid=1000,gid=1000 ://{NAS的主机名或IP}/{共享名}</code>(原文写的是 freenas.lan,FreeNAS 早就改名 TrueNAS 了,主机名按自己的实际填)</p>
</li>
<li>
<p>执行<code>systemctl enable autofs</code>, <code>systemctl restart autofs</code></p>
</li>
<li>
<p>使用<code>ll /mnt/nas</code>去验证是否挂载成功</p>
</li>
</ol></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/ubuntu/">Ubuntu</category><category domain="https://blog.alexc.cn/tags/cifs-utils/">Cifs-Utils</category><category domain="https://blog.alexc.cn/tags/autofs/">Autofs</category><category domain="https://blog.alexc.cn/tags/samba/">Samba</category></item><item><title>
Ubuntu修改本机IP与网关(netplan)</title><link>https://blog.alexc.cn/posts/ubuntu-20.04tls%E4%BF%AE%E6%94%B9%E6%9C%AC%E6%9C%BAip%E4%B8%8E%E7%BD%91%E5%85%B3/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/ubuntu-20.04tls%E4%BF%AE%E6%94%B9%E6%9C%AC%E6%9C%BAip%E4%B8%8E%E7%BD%91%E5%85%B3/</guid><pubDate>Sat, 12 Jun 2021 00:17:09 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>更新于 2026-10:原文写的是 Ubuntu 20.04,而 20.04 的标准支持已在 2025-05-31 结束;<code>gateway4</code> 这个键在新版 netplan 里也已弃用(会打印告警),本文改成官方推荐的 <code>routes</code> 写法,22.04 / 24.04 通用。</p>
</blockquote>
<blockquote>
<p>普通用户执行命令时,请在命令前加上<code>sudo</code></p>
</blockquote>
<h2 id="netplan"><a href="https://blog.alexc.cn/posts/ubuntu-20.04tls%E4%BF%AE%E6%94%B9%E6%9C%AC%E6%9C%BAip%E4%B8%8E%E7%BD%91%E5%85%B3/#netplan" class="anchor-link" aria-label="netplan"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu-20.04tls%E4%BF%AE%E6%94%B9%E6%9C%AC%E6%9C%BAip%E4%B8%8E%E7%BD%91%E5%85%B3/#contents:netplan" class="headings">netplan</a></h2>
<p>新版本ubuntu不再使用 <code>etc/network/interfaces</code> 配置本机IP和网关了,而是改用<code>netplan</code> 工具,网络配置文件位于<code>/etc/netplan</code> 文件夹中,格式为<code>.yaml</code>。</p>
<p>文件名各版本不太一样:Server 安装器生成的一般是 <strong>00-installer-config.yaml</strong>,云镜像 / 自动安装生成的是 <strong>50-cloud-init.yaml</strong>,桌面版(23.10 之后)由 NetworkManager 管理、但后端同样是 netplan。如果名字不一致的话请查看文件内容是否相似,配置文件内容如下:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span><span class="lnt">16
</span><span class="lnt">17
</span><span class="lnt">18
</span><span class="lnt">19
</span><span class="lnt">20
</span><span class="lnt">21
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">network</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="m">2</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">renderer</span><span class="p">:</span><span class="w"> </span><span class="l">networkd</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">ethernets</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># 以太网卡名称</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">ens18</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># 是否由dhcp服务器提供IP,true为是,false为否。为否时则需要配置静态IP</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">dhcp4</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># 本机静态IP地址</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">addresses</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="m">192.168.3.5</span><span class="l">/24</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># 所在局域网的网关。旧的 gateway4 / gateway6 键已弃用,改用 routes 声明默认路由</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">routes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">to</span><span class="p">:</span><span class="w"> </span><span class="l">default</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">via</span><span class="p">:</span><span class="w"> </span><span class="m">192.168.3.1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="c"># DNS服务器</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">nameservers</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">addresses</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="m">192.168.3.1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">ens0</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">dhcp4</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span></code></pre></td></tr></table></div>
</div>
</div><blockquote>
<p>如果目标机器是云镜像(配置来自 <code>50-cloud-init.yaml</code>),改之前得先禁用 cloud-init 的网络模块,不然重启后配置会被覆盖回去:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s1">&#39;network: {config: disabled}&#39;</span> <span class="p">|</span> sudo tee /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
</span></span></code></pre></td></tr></table></div>
</div>
</div></blockquote>
<h2 id="生效与检查"><a href="https://blog.alexc.cn/posts/ubuntu-20.04tls%E4%BF%AE%E6%94%B9%E6%9C%AC%E6%9C%BAip%E4%B8%8E%E7%BD%91%E5%85%B3/#生效与检查" class="anchor-link" aria-label="生效与检查"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/ubuntu-20.04tls%E4%BF%AE%E6%94%B9%E6%9C%AC%E6%9C%BAip%E4%B8%8E%E7%BD%91%E5%85%B3/#contents:生效与检查" class="headings">生效与检查</a></h2>
<ol>
<li>
<p>先做语法检查,再试应用。<code>netplan try</code> 会在 120 秒内等你按回车确认,没确认就自动回滚,远程改机器的时候可以保命:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo netplan generate
</span></span><span class="line"><span class="cl">sudo netplan try
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>确认无误后正式生效:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo netplan apply
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>查看当前网络状态(netplan 0.106 之后提供):</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">netplan status
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>验证 IP 和默认路由是否生效:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">ip a
</span></span><span class="line"><span class="cl">ip route
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
</ol>
<p>两点补充:<code>gateway4</code> / <code>gateway6</code> 现在虽然还能用,但 <code>netplan generate</code> 时会打印弃用告警,建议尽早迁到上面的 <code>routes</code> 写法;netplan 只管网卡和路由,DNS 是写给 systemd-resolved 的,如果 DNS 不生效,可以先用 <code>resolvectl status</code> 看解析器实际拿到的 DNS 是什么。</p></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/netplan/">Netplan</category><category domain="https://blog.alexc.cn/tags/ubuntu/">Ubuntu</category><category domain="https://blog.alexc.cn/tags/ip/">IP</category><category domain="https://blog.alexc.cn/tags/%E7%BD%91%E5%85%B3/">网关</category><category domain="https://blog.alexc.cn/tags/dns/">Dns</category></item><item><title>
PVE创建CT容器兼HomeLede尝鲜</title><link>https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/</guid><pubDate>Sat, 12 Jun 2021 00:09:05 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<p><em>参考链接:</em></p>
<ol>
<li>
<p><a href="https://www.right.com.cn/forum/thread-4053183-1-1.html" target="_blank" rel="noopener">恩山论坛教程</a></p>
</li>
<li>
<p><a href="https://github.com/xiaoqingfengATGH/HomeLede" target="_blank" rel="noopener">HomeLede项目主页</a></p>
</li>
<li>
<p><a href="https://p3terx.com/archives/build-openwrt-with-github-actions.html" target="_blank" rel="noopener">云端编译homelede在内的lede系统(P3TERX的教程)</a></p>
</li>
<li>
<p><a href="https://github.com/xiaoqingfengATGH/HomeLede/wiki/HomeLede-%E5%BC%80%E7%AE%B1-%E5%9F%BA%E7%A1%80%E6%93%8D%E4%BD%9C-%E4%BF%AE%E6%94%B9%E8%B7%AF%E7%94%B1IP" target="_blank" rel="noopener">修改路由IP(HomeLede wiki)</a></p>
</li>
</ol>
<p><em>补记:原文的参考链接里第3、5条是同一个地址(P3TERX 教程),第4条那篇 CSDN 文章已经 404,这里合并去重了。</em></p>
<h2 id="编译"><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#编译" class="anchor-link" aria-label="编译"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#contents:编译" class="headings">编译</a></h2>
<h3 id="方案一自己编译"><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#方案一自己编译" class="anchor-link" aria-label="方案一自己编译"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#contents:方案一自己编译" class="headings">方案一:自己编译</a></h3>
<ol>
<li>参照项目<code>README.md</code>给出的教程一路往下走,但在第七步配置软件包的时候,在<code>target images</code>选项中找到<code>rootfs</code>并勾选上<code>tar.gz</code></li>
<li>再往下走就能得到自己需要的PVE的容器模板
<ol>
<li>编译后的固件在当前目录的子目录<code>./bin/targets/x86/64</code> 里,我们所需要的容器模板的文件叫<code>openwrt-x86-64-generic-rootfs.tar.gz</code></li>
</ol>
</li>
</ol>
<h3 id="方案二云编译通过github的actions功能编译"><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#方案二云编译通过github的actions功能编译" class="anchor-link" aria-label="方案二云编译通过github的actions功能编译"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#contents:方案二云编译通过github的actions功能编译" class="headings">方案二:云编译(通过GitHub的Actions功能编译)</a></h3>
<p><em><del>我已在我的仓库配置好了,不想再动手操作一遍的话可以直接点进去下载最新的workflow编译好的固件</del> —— 那个个人仓库已经删掉了,链接失效;要用云编译请直接 fork HomeLede 官方仓库,按参考链接3的教程配置 Actions。</em></p>
<ol>
<li>参考<strong>参考链接3</strong>(当时因为 openethervpn5 的编译有问题,整个 HomeLede 都受影响,建议编译前先看一眼仓库最近的 issue 和 commit;这个项目现在仍在更新。原文在这里分享过我编译好的 CT 模板,那个 Google Drive 分享已经失效,需要同款模板的话按下面步骤自己编一个即可)
<ol>
<li>因为本身默认的配置并不会包含打包LXC所以要的容器模板,所以需要修改配置以打包出容器模板
<ol>
<li>参考 HomeLede 仓库里的 <code>.config</code>(我原来放在个人仓库里的那份已经删了),改成自己需要的配置</li>
<li>参考教程中的<code>SSH 连接到 Actions</code> 小节</li>
</ol>
</li>
</ol>
</li>
</ol>
<h2 id="安装"><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#安装" class="anchor-link" aria-label="安装"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#contents:安装" class="headings">安装</a></h2>
<ol>
<li>
<p>上传模板到PVE</p>
</li>
<li>
<p>因为webUI创建会迷之失败,所以接下来需要通过终端创建</p>
<ol>
<li>
<p>创建CT容器
<code>pct create {容器的ID} local:vztmpl/{模板名称} --rootfs local-lvm:{分配的系统盘大小} --ostype unmanaged --hostname {容器内外显示的主机名} --arch {系统架构} --cores {线程数} --memory {内存大小,单位是MB} --swap {交换分区大小,单位是MB} -{网络id} bridge={桥接网络},name={网络名称}</code>
将上方命令中必填项按自身需要修改即可,如: <code>pct create 201 local:vztmpl/openwrt-x86-64-generic-rootfs.tar.gz --rootfs local-lvm:1 --ostype unmanaged --hostname homelede --arch amd64 --cores 2 --memory 4096 --swap 512 -net0 bridge=vmbr0,name=eth0</code></p>
</li>
<li>
<p>编辑容器的相关读写权限
将以下内容追加到<code>/etc/pve/lxc/{容器ID}.conf</code> ,如我的即<code>为/etc/pve/lxc/201.conf</code> (<strong>注意,以下内容里也有地方要填写容器ID</strong> )</p>
<pre tabindex="0"><code>lxc.mount.auto: cgroup:rw
lxc.mount.auto: proc:rw
lxc.mount.auto: sys:rw
lxc.include: /usr/share/lxc/config/openwrt.common.conf
lxc.cap.drop: sys_admin
lxc.apparmor.profile: unconfined
lxc.cgroup.devices.allow: c 108:0 rwm
lxc.autodev: 1
lxc.cgroup.devices.allow: c 10:200 rwm
lxc.hook.autodev: /var/lib/lxc/{容器id}/device_hook.sh
lxc.mount.entry: tmp tmp tmpfs rw,nodev,relatime,mode=1777 0 0
</code></pre><p>如:</p>
<pre tabindex="0"><code>lxc.mount.auto: cgroup:rw
lxc.mount.auto: proc:rw
lxc.mount.auto: sys:rw
lxc.include: /usr/share/lxc/config/openwrt.common.conf
lxc.cap.drop: sys_admin
lxc.apparmor.profile: unconfined
lxc.cgroup.devices.allow: c 108:0 rwm
lxc.autodev: 1
lxc.cgroup.devices.allow: c 10:200 rwm
lxc.hook.autodev: /var/lib/lxc/201/device_hook.sh
lxc.mount.entry: tmp tmp tmpfs rw,nodev,relatime,mode=1777 0 0
</code></pre></li>
<li>
<p>在PVE的webUI上启动openwrt,并在容器内执行<code>mv /sbin/modprobe /sbin/mde</code></p>
<ol>
<li>
<p>如果启动失败,请检查 <code>/var/lib/lxc/{容器 ID}/device_hook.sh</code> 是否存在,如果不存在的话,请创建该文件,并写入以下内容:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span><span class="lnt">3
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">mknod /<span class="si">${</span><span class="nv">LXC_ROOTFS_MOUNT</span><span class="si">}</span>/dev/ppp c <span class="m">108</span> <span class="m">0</span>
</span></span><span class="line"><span class="cl">mkdir -p <span class="si">${</span><span class="nv">LXC_ROOTFS_MOUNT</span><span class="si">}</span>/dev/net
</span></span><span class="line"><span class="cl">mknod /<span class="si">${</span><span class="nv">LXC_ROOTFS_MOUNT</span><span class="si">}</span>/dev/net/tun c <span class="m">10</span> <span class="m">200</span>
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
</ol>
</li>
</ol>
</li>
<li>
<p>参考<a href="https://github.com/xiaoqingfengATGH/HomeLede/wiki/HomeLede-%E5%BC%80%E7%AE%B1-%E5%9F%BA%E7%A1%80%E6%93%8D%E4%BD%9C-%E4%BF%AE%E6%94%B9%E8%B7%AF%E7%94%B1IP" target="_blank" rel="noopener">这里</a>修改IP和DNS</p>
<h2 id="设置为旁路由"><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#设置为旁路由" class="anchor-link" aria-label="设置为旁路由"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/pve%E6%90%AD%E5%BB%BA%E9%83%A8%E7%BD%B2ct%E5%AE%B9%E5%99%A8%E5%85%BC%E8%BD%AF%E8%B7%AF%E7%94%B1%E5%B0%9D%E9%B2%9C/#contents:设置为旁路由" class="headings">设置为旁路由</a></h2>
</li>
<li>
<p>进入homelede,默认用户为<code>root</code>,默认密码为<code>password</code></p>
</li>
<li>
<p>去网络-接口,修改lan口</p>
<ol>
<li>设置<code>ipv4网关</code> 的值为主路由IP, 如我的是<code>192.168.3.1</code></li>
<li>DHCP-高级设置里勾选<code>强制</code> ,<code>DHCP选项</code> 的值设置为<code>6,{homelede的IP}</code> 如我的设置:<code>6,192.168.3.100</code></li>
<li>如果没有使用ipv6的需求的话就关掉ipv6,因为有的 OpenWrt 版本有 BUG,IPv6 可能影响到无线 AP 或者 DNS</li>
</ol>
</li>
<li>
<p>去网络-防火墙-常规设置里取消<code>启用 SYN-flood 防御</code>的勾选</p>
</li>
<li>
<p>重启homlede</p>
</li>
<li>
<p>找一台设备将网关设置为homelede的IP测试网络访问是否正常</p>
</li>
<li>
<p>进入主路由关闭主路由的DHCP功能并重启主路由</p>
</li>
<li>
<p>局域网内同一网段的设备重启以更新DHCP服务器为homelede</p>
</li>
</ol></description><category domain="https://blog.alexc.cn/categories/%E8%AE%B0%E5%BD%95/">记录</category><category domain="https://blog.alexc.cn/tags/pve/">PVE</category><category domain="https://blog.alexc.cn/tags/ct%E5%AE%B9%E5%99%A8/">CT容器</category><category domain="https://blog.alexc.cn/tags/%E8%BD%AF%E8%B7%AF%E7%94%B1/">软路由</category><category domain="https://blog.alexc.cn/tags/homelede/">Homelede</category></item><item><title>
为PVE配置APCUPSD断电后自动关机</title><link>https://blog.alexc.cn/posts/%E4%B8%BAnas%E9%85%8D%E7%BD%AEapcupsd%E6%96%AD%E7%94%B5%E5%90%8E%E8%87%AA%E5%8A%A8%E5%85%B3%E6%9C%BA/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E4%B8%BAnas%E9%85%8D%E7%BD%AEapcupsd%E6%96%AD%E7%94%B5%E5%90%8E%E8%87%AA%E5%8A%A8%E5%85%B3%E6%9C%BA/</guid><pubDate>Tue, 23 Mar 2021 00:52:45 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<ol>
<li>
<p>安装apcupsd</p>
<ol>
<li><code>apt install apcupsd -y</code></li>
</ol>
</li>
<li>
<p>配置apcupsd</p>
<ol>
<li>
<p>编辑 <code>/etc/apcupsd/apcupsd.conf</code></p>
<ul>
<li>
<p>配置通信方式</p>
<pre tabindex="0"><code>UPSCABLE usb #usb表示通过USB端口连接
UPSTYPE usb #usb表示通过USB端口通信
DEVICE #留空表示让APCUPSD自行获取UPS串口
</code></pre></li>
<li>
<p>配置为断电一定时间后就关机</p>
<pre tabindex="0"><code>TIMEOUT 0 #当值为0时,表示不设置该属性;当值为非零正数N时,表示切换到UPS电池供电N秒后就会通知主机关机
</code></pre></li>
<li>
<p>配置为可用电量或可用时间达到指定额度时关机</p>
<pre tabindex="0"><code>BATTERYLEVEL 5 #表示当可用电量为5%时,通知主机关机
MINUTES 3 #表示当UPS电池的可用时间为3分钟时,通知主机关机
</code></pre><p>TIMEOUT其值非零时,它与BATTERYLEVEL和MINUTES,这仨任意满足一个时就会关机</p>
</li>
</ul>
</li>
<li>
<p>编辑 <code>/etc/default/apcupsd</code></p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span><span class="lnt">3
</span><span class="lnt">4
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Defaults for apcupsd initscript (unused with systemd as init).</span>
</span></span><span class="line"><span class="cl"><span class="c1"># Set to &#34;yes&#34; to enable startup of apcupsd.</span>
</span></span><span class="line"><span class="cl"><span class="nv">ISCONFIGURED</span><span class="o">=</span>yes
</span></span><span class="line"><span class="cl"><span class="nv">APCACCESS</span><span class="o">=</span>/sbin/apcaccess
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>启动该服务且允许开机自启动</p>
<p><code>systemctl enable apcupsd &amp;&amp; systemctl restart apcupsd</code></p>
</li>
</ol>
</li>
<li>
<p>测试</p>
<p>执行 <code>apcaccess status</code> 后有类似如下信息则表示安装配置成功:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span><span class="lnt">13
</span><span class="lnt">14
</span><span class="lnt">15
</span><span class="lnt">16
</span><span class="lnt">17
</span><span class="lnt">18
</span><span class="lnt">19
</span><span class="lnt">20
</span><span class="lnt">21
</span><span class="lnt">22
</span><span class="lnt">23
</span><span class="lnt">24
</span><span class="lnt">25
</span><span class="lnt">26
</span><span class="lnt">27
</span><span class="lnt">28
</span><span class="lnt">29
</span><span class="lnt">30
</span><span class="lnt">31
</span><span class="lnt">32
</span><span class="lnt">33
</span><span class="lnt">34
</span><span class="lnt">35
</span><span class="lnt">36
</span><span class="lnt">37
</span><span class="lnt">38
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="o">[</span>root@pve<span class="o">]</span>~❯❯❯ apcaccess status
</span></span><span class="line"><span class="cl">APC : 001,036,0865
</span></span><span class="line"><span class="cl">DATE : 2021-03-17 00:14:16 +0800
</span></span><span class="line"><span class="cl">HOSTNAME : pve
</span></span><span class="line"><span class="cl">VERSION : 3.14.14 <span class="o">(</span><span class="m">31</span> May 2016<span class="o">)</span> debian
</span></span><span class="line"><span class="cl">UPSNAME : ups
</span></span><span class="line"><span class="cl">CABLE : USB Cable
</span></span><span class="line"><span class="cl">DRIVER : USB UPS Driver
</span></span><span class="line"><span class="cl">UPSMODE : Stand Alone
</span></span><span class="line"><span class="cl">STARTTIME: 2021-03-16 23:51:50 +0800
</span></span><span class="line"><span class="cl">MODEL : BK650M2-CH
</span></span><span class="line"><span class="cl">STATUS : ONBATT
</span></span><span class="line"><span class="cl">LINEV : 243.0 Volts
</span></span><span class="line"><span class="cl">LOADPCT : 19.0 Percent
</span></span><span class="line"><span class="cl">BCHARGE : 100.0 Percent
</span></span><span class="line"><span class="cl">TIMELEFT : 24.0 Minutes
</span></span><span class="line"><span class="cl">MBATTCHG : <span class="m">10</span> Percent
</span></span><span class="line"><span class="cl">MINTIMEL : <span class="m">5</span> Minutes
</span></span><span class="line"><span class="cl">MAXTIME : <span class="m">0</span> Seconds
</span></span><span class="line"><span class="cl">SENSE : Low
</span></span><span class="line"><span class="cl">LOTRANS : 160.0 Volts
</span></span><span class="line"><span class="cl">HITRANS : 278.0 Volts
</span></span><span class="line"><span class="cl">ALARMDEL : <span class="m">30</span> Seconds
</span></span><span class="line"><span class="cl">BATTV : 13.5 Volts
</span></span><span class="line"><span class="cl">LASTXFER : Automatic or explicit self <span class="nb">test</span>
</span></span><span class="line"><span class="cl">NUMXFERS : <span class="m">1</span>
</span></span><span class="line"><span class="cl">XONBATT : 2021-03-17 00:10:06 +0800
</span></span><span class="line"><span class="cl">TONBATT : <span class="m">255</span> Seconds
</span></span><span class="line"><span class="cl">CUMONBATT: <span class="m">255</span> Seconds
</span></span><span class="line"><span class="cl">XOFFBATT : N/A
</span></span><span class="line"><span class="cl">SELFTEST : OK
</span></span><span class="line"><span class="cl">STATFLAG : 0x05060010
</span></span><span class="line"><span class="cl">SERIALNO : 9B2015A09122
</span></span><span class="line"><span class="cl">BATTDATE : 2001-01-01
</span></span><span class="line"><span class="cl">NOMINV : <span class="m">220</span> Volts
</span></span><span class="line"><span class="cl">NOMBATTV : 12.0 Volts
</span></span><span class="line"><span class="cl">NOMPOWER : <span class="m">390</span> Watts
</span></span><span class="line"><span class="cl">END APC : 2021-03-17 00:14:21 +0800
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
</ol></description><category domain="https://blog.alexc.cn/categories/homelab/">Homelab</category><category domain="https://blog.alexc.cn/tags/nas/">NAS</category><category domain="https://blog.alexc.cn/tags/apcupsd/">APCUPSD</category><category domain="https://blog.alexc.cn/tags/%E6%96%AD%E7%94%B5%E5%85%B3%E6%9C%BA/">断电关机</category><category domain="https://blog.alexc.cn/tags/%E7%94%B5%E6%BA%90%E7%AE%A1%E7%90%86/">电源管理</category><category domain="https://blog.alexc.cn/tags/pve/">PVE</category></item><item><title>
【已失效】分享一些免费的Docker代理</title><link>https://blog.alexc.cn/posts/%E5%88%86%E4%BA%AB%E4%B8%80%E4%BA%9B%E5%85%8D%E8%B4%B9%E7%9A%84docker%E4%BB%A3%E7%90%86/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E5%88%86%E4%BA%AB%E4%B8%80%E4%BA%9B%E5%85%8D%E8%B4%B9%E7%9A%84docker%E4%BB%A3%E7%90%86/</guid><pubDate>Wed, 01 Apr 2020 22:57:45 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>本文列出的 Docker 公共镜像加速器已陆续停服或仅限特定网络环境使用,不能再按原配置直接使用。本文正文仅保留作历史参考。</p>
</blockquote>
<del>
<p>废话不多说,直接把我本地的 <code>daemon.json</code> 亮出来:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span><span class="lnt">11
</span><span class="lnt">12
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span>
</span></span><span class="line"><span class="cl"> <span class="nt">&#34;debug&#34;</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="nt">&#34;experimental&#34;</span><span class="p">:</span> <span class="kc">false</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="nt">&#34;registry-mirrors&#34;</span><span class="p">:</span> <span class="p">[</span>
</span></span><span class="line"><span class="cl"> <span class="s2">&#34;https://mirror.ccs.tencentyun.com&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="s2">&#34;https://registry.docker-cn.com&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="s2">&#34;https://dockerhub.azk8s.cn&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="s2">&#34;https://docker.mirrors.ustc.edu.cn&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="s2">&#34;https://reg-mirror.qiniu.com&#34;</span><span class="p">,</span>
</span></span><span class="line"><span class="cl"> <span class="s2">&#34;https://hub-mirror.c.163.com&#34;</span>
</span></span><span class="line"><span class="cl"> <span class="p">]</span>
</span></span><span class="line"><span class="cl"><span class="p">}</span>
</span></span></code></pre></td></tr></table></div>
</div>
</div><p>这些都是免登录的,可以直接用,感谢大厂们的免费提供。</p>
<p>还要感谢这篇<a href="https://juejin.im/post/5cd2cf01f265da0374189441" target="_blank" rel="noopener">文章</a>的作者, 这些代理站都是从这篇<a href="https://juejin.im/post/5cd2cf01f265da0374189441" target="_blank" rel="noopener">文章</a>里筛选出来的。</p>
</del></description><category domain="https://blog.alexc.cn/categories/%E5%B0%8F%E6%8A%80%E5%B7%A7/">小技巧</category><category domain="https://blog.alexc.cn/tags/docker/">Docker</category><category domain="https://blog.alexc.cn/tags/%E4%BB%A3%E7%90%86/">代理</category><category domain="https://blog.alexc.cn/tags/%E5%8A%A0%E9%80%9F/">加速</category><category domain="https://blog.alexc.cn/tags/docker-for-desktop/">Docker for Desktop</category></item><item><title>
我的开发环境之Linux篇</title><link>https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/</guid><pubDate>Sun, 29 Mar 2020 22:41:38 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>更新于 2026-10:原文写于 2021 年,其中 Linuxbrew、apt-key、docker-compose v1 这几处已经失效(Linuxbrew 的两个仓库都已归档、apt-key 已弃用、Compose v1 于 2023-07 停止支持),本次一并更新,示例基于 Ubuntu 22.04 / 24.04。</p>
</blockquote>
<blockquote>
<p>提前说明一下,对于Linux系统,我一向是倾向于用Ubuntu,所以以下的安装都是基于Ubuntu。Ubuntu 目前最新的 LTS 是 24.04(20.04 的标准支持已在 2025-05-31 结束),22.04 / 24.04 都适用下面的步骤。<del>即使我在家用的是macOS,但介绍的工具在macOS上也能用。</del></p>
</blockquote>
<h2 id="基本的应用"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#基本的应用" class="anchor-link" aria-label="基本的应用"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:基本的应用" class="headings">基本的应用</a></h2>
<p>一般新机器/系统到手的时候,我都会执行以下这条命令以方便后面的使用:</p>
<p><code>sudo apt update &amp;&amp; sudo apt upgrade -y &amp;&amp; sudo apt install curl git vim -y</code></p>
<h2 id="zsh"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#zsh" class="anchor-link" aria-label="zsh"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:zsh" class="headings">zsh</a></h2>
<p>当初刚接触Linux的时候, 就在网上找资料的时候被安利上了, 配合oh-my-zsh的<code>zsh-syntax-highlighting</code>和<code>zsh-autosuggestions</code>这两个插件是真的好用。</p>
<h3 id="zsh本体"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#zsh本体" class="anchor-link" aria-label="zsh本体"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:zsh本体" class="headings">zsh本体</a></h3>
<ol>
<li>
<p>安装zsh</p>
<p><code>sudo apt install zsh -y</code></p>
</li>
<li>
<p>切换到zsh</p>
<p><code>sudo chsh -s &quot;$(which zsh)&quot;</code></p>
</li>
</ol>
<p>执行完上述两步后,需要退出当前终端甚至是重启机器才能应用zsh。我<del>为了这篇文章装了个Ubuntu Desktop</del>测试安装步骤时发现,有时候哪怕重启了N多遍也没用,这种时候可以不用管,往下走安装oh-my-zsh,让oh-my-zsh老大哥来管……</p>
<h3 id="oh-my-zsh"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#oh-my-zsh" class="anchor-link" aria-label="oh-my-zsh"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:oh-my-zsh" class="headings">oh-my-zsh</a></h3>
<ol>
<li>
<p>安装本体</p>
<p><code>sh -c &quot;$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)&quot;</code></p>
<p>原文用的是 <code>raw.github.com</code> 这个域名,现在已经不推荐了,换成 <code>raw.githubusercontent.com</code>(国内网络下这两个域名都不好访问,建议挂代理)。</p>
<p>安装完成后,会问是否默认使用zsh,填 <code>y</code> 并回车,然后重启机器再打开终端,你就用上zsh了,且oh-my-zsh已经配置好默认配置了。</p>
</li>
<li>
<p>安装插件</p>
<ol>
<li>
<p>zsh-autosuggestions</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">git clone https://github.com/zsh-users/zsh-autosuggestions <span class="si">${</span><span class="nv">ZSH_CUSTOM</span><span class="k">:-</span><span class="nv">$HOME</span><span class="p">/.oh-my-zsh/custom</span><span class="si">}</span>/plugins/zsh-autosuggestions
</span></span></code></pre></td></tr></table></div>
</div>
</div><p>本插件的作用是根据输入自动建议符合输入内容的输入过的命令。</p>
</li>
<li>
<p>zsh-syntax-highlighting</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">git clone https://github.com/zsh-users/zsh-syntax-highlighting <span class="si">${</span><span class="nv">ZSH_CUSTOM</span><span class="k">:-</span><span class="nv">$HOME</span><span class="p">/.oh-my-zsh/custom</span><span class="si">}</span>/plugins/zsh-syntax-highlighting
</span></span></code></pre></td></tr></table></div>
</div>
</div><p>本插件的作用是如果你输入的工具名是存在的,那么该名字会以绿色高亮显示,否则为红色高亮。</p>
</li>
</ol>
<p>原文的 <code>git://github.com/...</code> 协议 GitHub 早已不支持,改用 <code>https://</code>。</p>
<p>安装好插件后,记得要去用户根目录的 <code>.zshrc</code> 里修改plugins数组,plugins数组默认有一个git插件,这里再额外加上上面两个插件的名字就行了:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="nv">plugins</span><span class="o">=(</span>git zsh-autosuggestions zsh-syntax-highlighting extract<span class="o">)</span>
</span></span></code></pre></td></tr></table></div>
</div>
</div><p>保存修改后可通过执行 <code>source ~/.zshrc</code> 在当前终端应用本次修改(原文写成了 <code>source ~./zshrc</code>,是个笔误)。</p>
</li>
<li>
<p>extract</p>
<p>顺带推荐一下这个插件,这个是oh-my-zsh自带的插件,用途是解压压缩包或存档文件,直接把这个名字写到plugins数组就可以(上面那行已经加上了)。</p>
</li>
</ol>
<h2 id="homebrew原-linuxbrew"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#homebrew原-linuxbrew" class="anchor-link" aria-label="homebrew原-linuxbrew"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:homebrew原-linuxbrew" class="headings">Homebrew(原 Linuxbrew)</a></h2>
<p>这个工具说是macOS下必备的开发工具应该不算夸张,在 Linux 上它的存在算是对 apt 的补完和拓展,<del>没了它依旧可以正常开发,但</del>有了它你的开发体验会更顺畅。</p>
<p><strong>「Linuxbrew」这个名字已经废弃了</strong>:<code>Linuxbrew/install</code> 和 <code>Linuxbrew/brew</code> 两个仓库都已经归档(分别停更于 2020 和 2019),现在统一叫 <strong>Homebrew on Linux</strong>,安装脚本从 Homebrew 官方仓库取。</p>
<p><em>Tips1:因为该工具在安装其它工具时其实本质是拉取发行版二进制并自动安装、或拉取源码到本地自动编译,这其中下载速度一般等同于从GitHub拉取源码,所以嫌慢的话,建议开代理。</em></p>
<p><em>Tips2:官方给出的 macOS 和 Linux 安装脚本是同一个,脚本内会自己做判断。</em></p>
<ol>
<li>
<p>安装(先把依赖装好:<code>sudo apt install build-essential procps curl file git -y</code>)</p>
<p><code>/bin/bash -c &quot;$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;</code></p>
<p>安装时因为会要用到 <code>sudo</code> , 所以要输一次密码;然后会再问一次是否确定要继续安装,按回车则继续,按其它则取消安装。如果可以的话建议走代理,因为拢共几百兆的东西要克隆/下载。</p>
</li>
<li>
<p>添加到path</p>
<p>Linux 上 Homebrew 的安装前缀固定在 <code>/home/linuxbrew/.linuxbrew</code>,安装完成后脚本会直接提示要执行的那行命令:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s1">&#39;eval &#34;$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)&#34;&#39;</span> &gt;&gt; ~/.zshrc
</span></span><span class="line"><span class="cl"><span class="nb">eval</span> <span class="s2">&#34;</span><span class="k">$(</span>/home/linuxbrew/.linuxbrew/bin/brew shellenv<span class="k">)</span><span class="s2">&#34;</span>
</span></span></code></pre></td></tr></table></div>
</div>
</div><p>比如我的是zsh,那么我把这句话添加到.zshrc里,以后打开终端就可以正常使用 <code>brew</code> 命令了;装完可以跑一次 <code>brew doctor</code> 自检。</p>
</li>
</ol>
<h2 id="sdkman"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#sdkman" class="anchor-link" aria-label="sdkman"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:sdkman" class="headings">sdkman</a></h2>
<p>安装、管理jdk版本的好工具,当然它也支持maven和gradle~~,不过这两个我装了就没动过版本了~~。主要还是用这个来管理、切换jdk版本。</p>
<ol>
<li>
<p>安装</p>
<p><code>curl -s &quot;https://get.sdkman.io&quot; | bash</code></p>
</li>
<li>
<p>(建议执行)应用到当前终端</p>
<p><code>source &quot;$HOME/.sdkman/bin/sdkman-init.sh&quot;</code></p>
<p>这一步不执行也没关系,但要关闭当前终端,然后新开一个终端,也能直接使用 <code>sdk</code> 命令。</p>
</li>
</ol>
<h2 id="docker"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#docker" class="anchor-link" aria-label="docker"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:docker" class="headings">docker</a></h2>
<p>docker在macOS和Windows上有docker for desktop,且自带 compose,故唯有Linux需要手动执行以下的安装步骤。</p>
<h3 id="docker与compose"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#docker与compose" class="anchor-link" aria-label="docker与compose"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:docker与compose" class="headings">docker与compose</a></h3>
<ol>
<li>
<p>移除系统自带的旧版本/冲突包</p>
<p><code>sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)</code></p>
</li>
<li>
<p>添加 Docker 的官方 GPG 密钥</p>
<p>原文用的是 <code>apt-key add</code>,这个命令在 Debian 12 / Ubuntu 24.04 已经弃用,现在改成 keyring 文件 + <code>signed-by</code> 的方式:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span><span class="lnt">3
</span><span class="lnt">4
</span><span class="lnt">5
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo apt update
</span></span><span class="line"><span class="cl">sudo apt install -y ca-certificates curl
</span></span><span class="line"><span class="cl">sudo install -m <span class="m">0755</span> -d /etc/apt/keyrings
</span></span><span class="line"><span class="cl">sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
</span></span><span class="line"><span class="cl">sudo chmod a+r /etc/apt/keyrings/docker.asc
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>添加apt仓库。Ubuntu 24.04 起 apt 支持 deb822 格式,下面这种写法 22.04 和 24.04 都能用:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt"> 1
</span><span class="lnt"> 2
</span><span class="lnt"> 3
</span><span class="lnt"> 4
</span><span class="lnt"> 5
</span><span class="lnt"> 6
</span><span class="lnt"> 7
</span><span class="lnt"> 8
</span><span class="lnt"> 9
</span><span class="lnt">10
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo tee /etc/apt/sources.list.d/docker.sources <span class="s">&lt;&lt;EOF
</span></span></span><span class="line"><span class="cl"><span class="s">Types: deb
</span></span></span><span class="line"><span class="cl"><span class="s">URIs: https://download.docker.com/linux/ubuntu
</span></span></span><span class="line"><span class="cl"><span class="s">Suites: $(. /etc/os-release &amp;&amp; echo &#34;${UBUNTU_CODENAME:-$VERSION_CODENAME}&#34;)
</span></span></span><span class="line"><span class="cl"><span class="s">Components: stable
</span></span></span><span class="line"><span class="cl"><span class="s">Architectures: $(dpkg --print-architecture)
</span></span></span><span class="line"><span class="cl"><span class="s">Signed-By: /etc/apt/keyrings/docker.asc
</span></span></span><span class="line"><span class="cl"><span class="s">EOF</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">sudo apt update
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
<li>
<p>安装docker(compose 现在是插件,跟着一起装)</p>
<p><code>sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y</code></p>
</li>
<li>
<p>验证</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">sudo docker run hello-world
</span></span><span class="line"><span class="cl">docker compose version
</span></span></code></pre></td></tr></table></div>
</div>
</div></li>
</ol>
<p>完工。</p>
<p>不过有个提醒,普通用户安装docker后,需要前置 <code>sudo</code> 来调用 <code>docker</code> 命令,比如 <code>docker ps</code> 这句命令,直接执行是会提示permission denied的,要加上sudo, <code>sudo docker ps</code> 这样才能执行成功。如果你不介意当前用户获得root权限的话,可以使用<code>usermod -aG docker {username}</code>来将当前用户加入到docker组,这样执行<code>docker</code>命令的时候就无需前置<code>sudo</code>了(注意:docker 组的权限等价于 root,只在个人机器上这么干)。</p>
<h3 id="关于-docker-compose"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#关于-docker-compose" class="anchor-link" aria-label="关于-docker-compose"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:关于-docker-compose" class="headings">关于 docker-compose</a></h3>
<p><strong>原文那套「下载 docker-compose 1.25.4 二进制放到 <code>/usr/local/bin</code>」的做法已经作废</strong>:Compose v1(Python 版)在 2023-07 就停止支持了,现在的命令是 <code>docker compose</code>(子命令形式,由 <code>docker-compose-plugin</code> 提供),写法上把原来的 <code>docker-compose up -d</code> 换成 <code>docker compose up -d</code> 即可。另外 compose 文件顶层的 <code>version:</code> 键也已废弃,写了会告警并被忽略,直接删掉即可。</p>
<h3 id="国内拉镜像"><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#国内拉镜像" class="anchor-link" aria-label="国内拉镜像"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E4%B9%8Blinux%E7%AF%87/#contents:国内拉镜像" class="headings">国内拉镜像</a></h3>
<p>再补一句国内网络的现状:以前往 <code>/etc/docker/daemon.json</code> 里塞一长串公共加速器(<code>registry.docker-cn.com</code>、<code>reg-mirror.qiniu.com</code>、<code>hub-mirror.c.163.com</code>、<code>docker.mirrors.ustc.edu.cn</code> 之类)的做法<strong>已经失效</strong>——2024 年年中开始,这些公共 Docker Hub 镜像加速服务相继关停,其中 <code>registry.docker-cn.com</code>、<code>reg-mirror.qiniu.com</code> 是直接停止服务,<code>dockerhub.azk8s.cn</code> 转为内部使用,USTC 的也已在 2024-06-06 关闭。现在还行的路子是:</p>
<ul>
<li>给 dockerd 配 HTTP 代理(写 <code>/etc/systemd/system/docker.service.d/http-proxy.conf</code>),让拉取走代理</li>
<li>用云服务器所在厂商的内网镜像(只有该厂商的机器能用)</li>
<li>自建 pull-through cache</li>
</ul>
<p>本博客里那篇《分享一些免费的Docker代理》正是因为这件事整篇作废了。</p></description><category domain="https://blog.alexc.cn/categories/%E6%88%91%E7%9A%84%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/">我的开发环境</category><category domain="https://blog.alexc.cn/tags/%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83/">开发环境</category><category domain="https://blog.alexc.cn/tags/zsh/">Zsh</category><category domain="https://blog.alexc.cn/tags/oh-my-zsh/">Oh-My-Zsh</category><category domain="https://blog.alexc.cn/tags/linuxbrew/">Linuxbrew</category><category domain="https://blog.alexc.cn/tags/homebrew/">Homebrew</category><category domain="https://blog.alexc.cn/tags/sdkman/">Sdkman</category><category domain="https://blog.alexc.cn/tags/docker/">Docker</category><category domain="https://blog.alexc.cn/tags/docker-compose/">Docker-Compose</category><category domain="https://blog.alexc.cn/tags/ubuntu/">Ubuntu</category></item><item><title>
最近在VPS上部署sonarqube踩了个坑</title><link>https://blog.alexc.cn/posts/%E6%9C%80%E8%BF%91%E5%9C%A8vps%E4%B8%8A%E9%83%A8%E7%BD%B2sonarqube%E8%B8%A9%E4%BA%86%E4%B8%AA%E5%9D%91/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E6%9C%80%E8%BF%91%E5%9C%A8vps%E4%B8%8A%E9%83%A8%E7%BD%B2sonarqube%E8%B8%A9%E4%BA%86%E4%B8%AA%E5%9D%91/</guid><pubDate>Sun, 08 Dec 2019 23:49:54 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<p>先说一下环境:</p>
<div class="highlight"><div class="chroma">
<div class="table-container"><table class="lntable"><tr><td class="lntd">
<pre tabindex="0" class="chroma"><code><span class="lnt">1
</span><span class="lnt">2
</span></code></pre></td>
<td class="lntd">
<pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">~ uname -a
</span></span><span class="line"><span class="cl">Linux vmi237400.contaboserver.net 4.9.0-9-amd64 <span class="c1">#1 SMP Debian 4.9.168-1+deb9u4 (2019-07-19) x86_64 GNU/Linux</span>
</span></span></code></pre></td></tr></table></div>
</div>
</div><p>这是我在contabo上买的一个VPS, 我在上面跑的OS是Debian.</p>
<p>前两天用docker-compose部署sonarqube的时候, 发现sonarqube一直在重启, 然后我用<code>sudo docker logs sonarqube</code>去看的时候发现, 是里面的es一直跑不起来, 提示要我把<code>vm.max_map_count</code>这个东西调整为<code>262144</code>以上, 然后我查了下资料, 可以在宿主机上跑了<code>sudo sysctl -w vm.max_map_count=262144</code>后, sonarqube就可以正常启动了, 不过这个只是临时有效, 如果机器重启后还是会再次无法启动. 而持久性修改的办法则是到<code>/etc/systctl.conf</code>中修改<code>vm.max_map_count</code>的值为<code>262144</code>, 如果在文件中找不到的话, 可以把这个属性加上. 图省事的话可以用<code>echo &quot;vm.max_map_count=262144&quot; &gt; /etc/sysctl.conf</code>. 改完之后重启系统就可以了.</p></description><category domain="https://blog.alexc.cn/categories/%E5%B0%8F%E6%8A%80%E5%B7%A7/">小技巧</category><category domain="https://blog.alexc.cn/tags/sonarqube/">Sonarqube</category><category domain="https://blog.alexc.cn/tags/docker-compose/">Docker-Compose</category><category domain="https://blog.alexc.cn/tags/docker/">Docker</category><category domain="https://blog.alexc.cn/tags/linux/">Linux</category></item><item><title>
【已失效】在DNS服务商申请token给traefik用来申请证书</title><link>https://blog.alexc.cn/posts/%E5%9C%A8dns%E6%9C%8D%E5%8A%A1%E5%95%86%E7%94%B3%E8%AF%B7token%E7%BB%99traefik%E7%94%A8%E6%9D%A5%E7%94%B3%E8%AF%B7%E8%AF%81%E4%B9%A6/</link><guid isPermaLink="true">https://blog.alexc.cn/posts/%E5%9C%A8dns%E6%9C%8D%E5%8A%A1%E5%95%86%E7%94%B3%E8%AF%B7token%E7%BB%99traefik%E7%94%A8%E6%9D%A5%E7%94%B3%E8%AF%B7%E8%AF%81%E4%B9%A6/</guid><pubDate>Sun, 24 Nov 2019 22:08:22 +0800</pubDate><author>alexcdever@gmail.com (Alex Chen)</author><copyright>[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)</copyright><description>
<blockquote>
<p>本文使用 Traefik v2.0.4 及旧版 lego DNSPod 集成,相关版本和配置方式已经过时,文中的 DNSPod 令牌流程不能直接用于当前 Traefik;配套图片资源也已失效。本文正文仅保留作历史参考。</p>
</blockquote>
<del>
<h2 id="dnspod"><a href="https://blog.alexc.cn/posts/%E5%9C%A8dns%E6%9C%8D%E5%8A%A1%E5%95%86%E7%94%B3%E8%AF%B7token%E7%BB%99traefik%E7%94%A8%E6%9D%A5%E7%94%B3%E8%AF%B7%E8%AF%81%E4%B9%A6/#dnspod" class="anchor-link" aria-label="dnspod"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="icon anchor-icon"><path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"/></svg></a><a href="https://blog.alexc.cn/posts/%E5%9C%A8dns%E6%9C%8D%E5%8A%A1%E5%95%86%E7%94%B3%E8%AF%B7token%E7%BB%99traefik%E7%94%A8%E6%9D%A5%E7%94%B3%E8%AF%B7%E8%AF%81%E4%B9%A6/#contents:dnspod" class="headings">DNSPOD</a></h2>
<ol>
<li>登录<a href="https://dnspod.cn" target="_blank" rel="noopener">官网</a></li>
<li>在控制台中打开安全设置</li>
</ol>